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.

qname-cli API scope

qname-cli stays intentionally narrow in its first public shape. It is for WHOIS/domain lookup itself; traffic lookup can be requested as a separate API type but is not exposed by the CLI.

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 qname-cli
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.