Skip to content

tanishqsh/domain-cli

Repository files navigation

Domainstorm

npm version npm downloads

Domainstorm is the fastest way to go from "we need a name" to "these are the domains we can buy now."

It is built for AI and agent products where naming cycles happen fast and every good domain disappears quickly.

Why Domainstorm

  • One command for ideation and availability checks
  • Built for agent-native products (agent, mcp, ops, runtime, router naming patterns)
  • WHOIS-based checks across TLDs with optional registry server override
  • CLI-first output that works cleanly in agent and CI workflows
  • CSV export for founders, marketers, and legal review

Install

npm i -g domainstorm@latest

Run instantly without global install:

npx --yes domainstorm --help

Update to latest:

npm update -g domainstorm

Quick Wins

Brainstorm + check + return only likely available:

domainstorm --brainstorm "agent orchestration" "mcp broker" --tld md --server whois.nic.md --dns-prefilter --only-available --table

Check exact domains:

domainstorm broker.md --server whois.nic.md --dns-prefilter

Default output is plain English (for example: ✅ broker.md is available.). Use --table if you want a structured table view.

Check from file and export CSV:

domainstorm --input domains.txt --output /tmp/domainstorm.csv

Try immediately with the bundled candidate list:

domainstorm --input agent-candidates.txt --tld md --server whois.nic.md --only-available --table

Built For Agent Workflows

Use Domainstorm when your coding/research agent needs to propose names and validate them in the same run.

  • Deterministic CLI output
  • Works with shell pipelines
  • No external AI API keys required
  • No seed ideas? Ask your agent of choice (Codex, Claude, etc.) for seed phrases and pass them to --brainstorm

Compatibility alias:

domain-check --help

Zero Install — Just npx

Agents don't need to install anything globally. Domainstorm works out of the box with npx:

npx domainstorm --brainstorm "agent runtime" --tld com --only-available --table

No setup, no config, no API keys. One command and the agent has domain availability data. This makes it trivial to add to any agent's tool chain — just shell out to npx domainstorm and parse the output.

Works with Claude Code, Codex, OpenClaw, Cursor, and any agent that can run shell commands.

Example Output

✅ broker.md is available.
❌ agentops.md is not available (already registered).
Summary: ✅ 1 available, ❌ 1 taken, ⚠️ 0 unknown.

Output columns:

  • domain
  • status (registered, likely_available, unknown)
  • reason
  • state (registry/DNS state when available)
  • legal_risk (low, high_tm_risk)
  • story (brainstorm narrative tag)
  • error

Key Flags

  • --brainstorm / --storm
  • --max-suggestions <n> (default: 120)
  • --table
  • --plain
  • --input <file>
  • --output <file>
  • --tld <tld> (default: md)
  • --server <whois-host>
  • --dns-prefilter
  • --only-available
  • --concurrency <n>
  • --timeout-ms <n>
  • --raw

OpenClaw / AI Agent Skill

Domainstorm ships as an OpenClaw skill. Install it with a single npx command — no global install needed:

npx domainstorm --install-skill

This launches an interactive installer that lets you pick where to install the skill (Claude Code, OpenClaw, Cursor, or a custom path). Once installed, your agent will automatically use Domainstorm when you ask it to brainstorm or check domains.

You can also print the skill file to stdout for manual setup:

npx domainstorm --skill

Works with any agent that supports OpenClaw skills — Claude, Codex, Cursor, and others.

Notes

  • WHOIS formats vary by registry; treat likely_available as a pre-check, not final registrar checkout.
  • Registries can rate-limit bulk lookups; retry unknown rows after cooldown.
  • Domainstorm includes registry adapters for .md, .com, .org, and .ai to improve state parsing.
  • Domainstorm auto-throttles WHOIS to concurrency 2 across TLDs (override with --concurrency).
  • For .md, Domain state is parsed explicitly (Inactive, OK, OK Delegated, and no-match states).
  • --dns-prefilter runs DNS first and marks resolving domains as taken before WHOIS (faster and lighter on WHOIS quota).
  • Install whois locally (brew install whois on macOS).

About

Let your agents brainstorm and check domain availability with high accuracy

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors