Domainion Ops

Domain and DNS operations across name.com (default), GoDaddy, and Namecheap. Use for registering domains, flipping nameservers, managing DNS records (A, AAAA...

Multi-provider domain and DNS management. Default provider: name.com.

Provider Selection

Provider	When to use	Reference
name.com (default)	Unless user specifies otherwise	references/name-com.md
GoDaddy	User says "GoDaddy" or has GoDaddy account	references/godaddy.md
Namecheap	User says "Namecheap" or has Namecheap account	references/namecheap.md

Read only the relevant provider reference. Do not load all three.

Credentials Setup

Before any operation, verify credentials exist. Store in env or ~/.domainion:

# name.com (default)
NAMECOM_USERNAME=your_username
NAMECOM_TOKEN=your_api_token      # name.com > Account > API Settings

# GoDaddy
GODADDY_API_KEY=your_key
GODADDY_API_SECRET=your_secret   # developer.godaddy.com > API Keys

# Namecheap
NAMECHEAP_USERNAME=your_username
NAMECHEAP_API_KEY=your_api_key   # namecheap.com > Profile > Tools > API Access
NAMECHEAP_CLIENT_IP=your_ip      # Your whitelisted IP

If credentials are missing, prompt the user for the relevant provider's creds before proceeding.

Common Workflows

1. Check domain availability

# name.com (default)
curl -u "$NAMECOM_USERNAME:$NAMECOM_TOKEN" \
  "https://api.name.com/v4/domains:checkAvailability" \
  -d '{"domainNames":["example.com"]}'

→ See provider reference for GoDaddy / Namecheap equivalents.

2. DNS record management (add/update/delete)

Load provider reference for exact API calls. General pattern:

• List records first to confirm state
• Add or Update with idempotency check (avoid duplicates)
• Verify with dig after change

3. Nameserver change

Always confirm registrar before changing NS. Wrong registrar = silent failure. Load provider reference for exact API call.

4. Verify DNS propagation

# Primary check (Cloudflare resolver — fast TTL)
dig +short example.com @1.1.1.1

# Authoritative check
dig +short example.com @8.8.8.8

# Full record check
dig example.com ANY +noall +answer

# HTTP redirect verify
curl -sI https://example.com | grep -i location

5. TTL Strategy

• Lowering TTL before a change: set to 300 (5 min) at least 1 TTL cycle before
• After change confirmed: restore to 3600 or higher
• Never lower TTL after making the change — too late

Guardrails

• Confirm domain + provider before any destructive action (NS change, record delete)
• List existing records before adding to avoid duplicates
• Prefer reversible steps; verify after each change
• Never expose API tokens/secrets in output
• For MX changes: always keep at least one valid MX record live during migration