{"slug": "show-hn-namecom-cli-cli-and-agent-skill-so-claude-code-codex-can-do-your-dns", "title": "Show HN: Namecom-CLI – CLI and agent skill so Claude Code/Codex can do your DNS", "summary": "A developer released namecom-cli, a command-line tool for Name.com DNS and domain management built on the v4 API, designed for both human and AI agent use. The tool supports idempotent operations, secure credential storage, and includes a Claude/Codex skill for agent-driven automation.", "body_md": "A fast, **agent-friendly** command-line tool for [Name.com](https://www.name.com) DNS and domains, built on the current **v4 API**.\n\n+ a`--json`\n\neverywhere`commands`\n\nintrospection command, so AI agents can discover and drive the whole surface**Idempotent**(create-or-update, never duplicate) — the right primitive for automation and IaC`records set`\n\n**Secure auth**— credentials live in the macOS Keychain (or a`0600`\n\nconfig file), never in your shell environment**Zero native dependencies**— just Node 20+ and a few small pure-JS deps (`commander`\n\n,`@clack/prompts`\n\n,`picocolors`\n\n)\n\nWhy this exists: the only prior community tool (\n\n`namedns`\n\n) has been unmaintained since 2018 and targets Name.com's dead v1 reseller API.`namecom-cli`\n\nuses the current v4 API and is designed to be driven by humans and agents alike.\n\n```\n# one-off\nnpx namecom-cli --help\n\n# or globally\nnpm install -g namecom-cli\nnamecom --help\n```\n\nThis repo ships a Claude/Codex skill that teaches an agent to drive the CLI. The CLI can install its own skill:\n\n```\nnamecom skill install --agent claude-code      # or: --agent codex\nnamecom skill path                             # prints the bundled SKILL.md for manual/offline install\n```\n\n…or use the official skills CLI directly:\n\n```\nnpx skills add hypersocialinc/namecom-cli --skill namecom --agent claude-code\n```\n\nThe skill is written to work zero-install — it calls `npx namecom-cli`\n\nwhen the\n`namecom`\n\nbinary isn't on PATH — so adding only the skill still works.\n\nCreate a **production** API token at [https://www.name.com/account/settings/api](https://www.name.com/account/settings/api) (you get a username + token), then:\n\n```\nnamecom login                                  # prompts for username + token (masked) at a TTY;\n                                               # offers to open the token page in your browser\nnamecom login --user <username> --token <token># or pass them directly / via env\n```\n\nInteractive only for humans.Prompts, spinners, and color appear only when you're at a real terminal. When output is piped, in CI, an agent is driving, or you pass`--json`\n\n, the CLI is fully non-interactive and deterministic — missing inputs become a clean error, never a hung prompt. (`namecom`\n\nand`namecom-cli`\n\nare both valid commands.)\n\n`login`\n\nverifies the credentials, then stores them in your macOS Keychain (`namecom_user`\n\n/ `namecom_token`\n\n). You can also just set `NAMECOM_USER`\n\n/ `NAMECOM_TOKEN`\n\nin the environment and skip `login`\n\n.\n\nResolution order on every command: `--user/--token`\n\nflags → env vars → Keychain → `~/.config/namecom/credentials.json`\n\n.\n\n```\nnamecom whoami                          # verify auth, show domain count\nnamecom domains list                    # list every domain in the account\n\nnamecom records list example.com                 # all records\nnamecom records list example.com --type TXT      # filter by type\nnamecom records list example.com --host send     # filter by host\n\nnamecom records create example.com --host www --type CNAME --answer example.vercel.app\nnamecom records update example.com 12345 --ttl 600\nnamecom records delete example.com 12345\n\n# Idempotent upsert — safe to run repeatedly, never creates duplicates:\nnamecom records set example.com --host send --type MX \\\n  --answer feedback-smtp.us-east-1.amazonses.com --priority 10\n```\n\nAdd `--json`\n\nto any command for machine-readable output, and `--api-url https://api.dev.name.com`\n\nto target the sandbox.\n\n```\nnamecom records set example.com --host 'resend._domainkey.mail' --type TXT --answer 'p=MIGf...'\nnamecom records set example.com --host 'send.mail' --type MX --answer 'feedback-smtp.us-east-1.amazonses.com' --priority 10\nnamecom records set example.com --host 'send.mail' --type TXT --answer 'v=spf1 include:amazonses.com ~all'\nnamecom commands         # full command tree as JSON\nnamecom <cmd> --json     # structured output for any command\n```\n\n`@`\n\nmeans the zone apex (root). Hosts are relative to the domain (e.g. host `send`\n\non `example.com`\n\n→ `send.example.com`\n\n).\n\n- Scope is\n**DNS records**(`list/get/create/update/delete/set`\n\n) and read-only.`domains list`\n\n- Not (yet) covered: nameservers, URL forwarding, domain registration/transfer/contacts. The\n`client/`\n\nlayer is kept separate from commands so these are easy to add. - This is an unofficial tool and is not affiliated with Name.com.\n\n`namecom-cli`\n\nis **v1 of a provider-agnostic \"agents can do DNS\" tool**. The\nregistrar API (`src/client.js`\n\n) is a separate layer from the commands, so adding\nanother provider is a small, well-scoped contribution.\n\n**Wanted — help expand it to more registrars:**\n\n- Cloudflare\n- AWS Route 53\n- Porkbun\n- Namecheap\n\nIf \"agents that can do DNS\" should work for *your* registrar, come build it — see\n[good first issues](https://github.com/hypersocialinc/namecom-cli/labels/good%20first%20issue)\nand [CONTRIBUTING.md](/hypersocialinc/namecom-cli/blob/main/CONTRIBUTING.md) (it documents the provider interface).\n\nMIT © Hypersocial, Inc.", "url": "https://wpnews.pro/news/show-hn-namecom-cli-cli-and-agent-skill-so-claude-code-codex-can-do-your-dns", "canonical_source": "https://github.com/hypersocialinc/namecom-cli", "published_at": "2026-06-20 15:51:34+00:00", "updated_at": "2026-06-20 16:07:36.923464+00:00", "lang": "en", "topics": ["developer-tools", "ai-agents", "ai-tools"], "entities": ["Name.com", "Claude", "Codex", "macOS Keychain", "npm"], "alternates": {"html": "https://wpnews.pro/news/show-hn-namecom-cli-cli-and-agent-skill-so-claude-code-codex-can-do-your-dns", "markdown": "https://wpnews.pro/news/show-hn-namecom-cli-cli-and-agent-skill-so-claude-code-codex-can-do-your-dns.md", "text": "https://wpnews.pro/news/show-hn-namecom-cli-cli-and-agent-skill-so-claude-code-codex-can-do-your-dns.txt", "jsonld": "https://wpnews.pro/news/show-hn-namecom-cli-cli-and-agent-skill-so-claude-code-codex-can-do-your-dns.jsonld"}}