Agent-native CLI

qname-cli

A terminal interface for QName domain intelligence, built so humans and AI agents can run approved WHOIS lookups with predictable commands and structured output.

Request API accessnpm packageGitHub repo
Install and run
qname-cli
1npm install -g @qname/cli
2npx skills add QNameAI/qname-cli -y -g
3qname-cli init --api-key <approved-key>
4qname-cli whois qname.ai example.com --pretty

CLI first

Use QName from scripts, terminals, and agent workflows without opening the web app for every domain lookup.

Approved credentials

API access starts from a user request and admin approval, so usage stays tied to a known QName account.

Agent Skill included

Install the public Skill so Codex, Claude, and other agents know when to call qname-cli and how to read the result.

Current API scope

The API is intentionally narrow while qname-cli is in its first public shape. It is for domain lookup itself, not traffic enrichment or broader account automation.

WHOIS lookup with qname-cli whois up to the approved quota
Pretty terminal output for people and JSON output for automation
Agent-native usage through npx skills add QNameAI/qname-cli
Multi-domain requests are capped by the approved key quota
No traffic, backlink, ranking, or domain profile data through this API
API keys must be approved before qname-cli init can be used

How the CLI and Skill work together

The npm package installs the executable. The Skill is a separate instruction layer that teaches an AI agent the safe command surface, expected inputs, and current API limits.

  1. 1Install @qname/cli globally so qname-cli is available in the terminal.
  2. 2Install the QNameAI/qname-cli Skill globally for your agent workspace.
  3. 3Initialize qname-cli once with an approved API key from QName settings.
  4. 4Run qname-cli whois within the approved domain quota and inspect the output.