@namemyapp/cli

Command-line tool for namemy.app — check domain availability and hand AI agents a one-click buy URL from your terminal or any AI shell.

npx @namemyapp/cli link codeflow.ai

Install

# One-off (no install)
npx @namemyapp/cli link codeflow.ai

# Or install globally
npm i -g @namemyapp/cli
nma link codeflow.ai

The package ships two bin names: nma (short) and namemyapp (full). Pick whichever you prefer.

Quick reference

# Always available (no API key required)
nma link codeflow.ai
nma link codeflow.ai --price 13.20
nma link codeflow.ai --json

# Requires NAMEMYAPP_API_KEY
nma check codeflow.ai
nma check --bulk codeflow.ai codeflow.dev codeflow.io
nma generate "AI task manager" -t .com,.io,.ai
nma buy codeflow.ai
nma list

# Brand workflow (requires API key + paid features)
nma conflict "TaskFlow"
nma logo "TaskFlow" "AI task manager for teams"
nma legal "TaskFlow" -t saas
nma brand-kit "TaskFlow" -i saas
nma social-kit "TaskFlow" -i saas -a "engineering teams"

Why two bin names

nma is for fast typing in shells and AI agent contexts. namemyapp is for scripts and docs where the longer name is clearer.

Connecting AI agents

If you want an AI agent (Claude Desktop, ChatGPT, Cursor, Windsurf) to call namemy.app directly, the CLI is the wrong tool — point them at the remote MCP server instead:

https://mcp.namemy.app/mcp

Setup snippets for every major client live at https://namemy.app/agents. Use the CLI for terminal workflows and CI; use MCP for in-chat agent control.

Authentication

Most commands require NAMEMYAPP_API_KEY (free at https://namemy.app/app/api-keys):

export NAMEMYAPP_API_KEY=nma_live_...
nma check codeflow.ai

Or pass it inline:

nma --key nma_live_... check codeflow.ai

The link command never needs a key — it's a pure URL builder, no network call. Use it as the always-available primitive when you want to hand a user a buyable URL from a script, AI agent, or shell.

Commands

| Command | Auth | Description | |---------|------|-------------| | nma link <domain> [--price] | none | Print a one-click buy URL | | nma check <domain> | key | Single-domain availability + price | | nma check --bulk <d1> <d2>... | key | Bulk availability check | | nma generate <description> | key | AI name generation with availability | | nma buy <domain> | key | Server-to-server domain purchase | | nma list | key | List your registered domains | | nma conflict <name> | key | USPTO + web brand-conflict check | | nma logo <name> <description> | key | Generate AI logo concepts (paid) | | nma legal <businessName> -t <type> | key | Privacy/Terms/Cookie policies (paid) | | nma brand-kit <name> | key | Complete brand kit (paid) | | nma social-kit <name> -i <industry> -a <audience> | key | Social media kit (paid) |

Use nma <command> --help for full options on any command.

Environment variables

| Var | Default | Purpose | |-----|---------|---------| | NAMEMYAPP_API_KEY | — | Bearer token for all but link | | NAMEMYAPP_API_URL | https://namemy.app | Override for staging / self-hosted | | NAMEMYAPP_AGENT_SOURCE | cli | Attribution tag stamped on every API call + buyUrl |

Attribution

Set NAMEMYAPP_AGENT_SOURCE=my-tool to credit a specific tool / script / pipeline for conversions. namemy.app records source on every Purchase row and ships PostHog events for revenue attribution.

Use from any AI shell

The link command is the always-available primitive that any shell or AI agent can call to hand a user a buyable URL — no API key, no network round-trip:

$ nma link codeflow.ai
https://namemy.app/checkout?domain=codeflow.ai&source=cli

Pipe through --json for structured output:

$ nma link codeflow.ai --price 13.20 --json
{"domain":"codeflow.ai","buyUrl":"https://namemy.app/checkout?domain=codeflow.ai&price=13.20&source=cli","price":13.2}

Source + license

MIT. Source at https://github.com/Rakesh1002/namemyapp/tree/main/packages/cli.