rr-domain-cli

name: rr-domain-cli description: | Manage domains, DNS zones, and contacts via RealtimeRegister API. Use when: checking domain availability, registering/renewing domains, managing DNS records, creating contacts, tracking async processes. Trigger phrases: "domain availability", "register domain", "DNS records", "RealtimeRegister", "rr command", "domain expiry", "transfer domain" license: MIT homepage: https://github.com/dedene/realtime-register-cli metadata: author: dedene version: "1.2.0" openclaw: primaryEnv: RR_API_KEY requires: env: - RR_API_KEY bins: - rr install: - kind: brew tap: dedene/tap formula: rr bins: [rr] - kind: go package: github.com/dedene/realtime-register-cli/cmd/rr bins: [rr]

rr CLI - RealtimeRegister Domain Management

CLI for RealtimeRegister domain registrar. Manage domains, DNS, contacts, and processes.

When to Use

• Check domain availability (single or bulk)
• Register, renew, transfer, or delete domains
• Manage DNS zones and records
• Create/update WHOIS contacts
• Monitor async processes (registrations, transfers)
• Check account status and expiring domains

Prerequisites

# Install
brew install dedene/tap/rr

# Authenticate (stores in keyring)
rr auth login

# Or use environment variable
export RR_API_KEY=your-api-key

# Set customer handle (required for contacts)
rr config set customer mycustomer

Pagination

All list commands return max 50 results by default. Use --limit and --offset to paginate:

rr domain list --limit 100              # First 100
rr domain list --limit 100 --offset 100 # Next 100

Loop to get all results:

offset=0; while true; do
  batch=$(rr domain list --limit 100 --offset $offset --json)
  [ "$(echo "$batch" | jq length)" -eq 0 ] && break
  echo "$batch" | jq -r '.[].domainName'
  offset=$((offset + 100))
done

Output Formats

Always use --json for parsing. TSV (--plain) for simple scripting.

rr domain list          # Table (human-readable)
rr domain list --json   # JSON (for parsing)
rr domain list --plain  # TSV (tab-separated)

Command Quick Reference

Domains

Contacts

DNS Zones

Zone arguments accept a numeric zone ID or a domain name — rr zone get, zone update, zone delete, zone sync, and all zone record subcommands resolve a domain to its zone automatically. No need to look up the numeric ID first.

Other

Common Workflows

Check and Register Domain

rr domain check example.com --json
rr domain register example.com --registrant mycontact --period 1 -y

Bulk Availability Check

rr domain check-bulk domain1.com domain2.net domain3.io --json

Create Contact First

rr contact create myhandle \
  --name "John Doe" --email john@example.com \
  --phone "+1.5551234567" --country US

DNS Zone Management

# Address the zone by domain name directly — no ID lookup needed:
rr zone record add example.com --type A --name www --content 1.2.3.4 --ttl 3600
rr zone record update example.com --type TXT --name @ \
  --content "v=spf1 include:_spf.example.net ~all" \
  --old-content "v=spf1 ~all"
rr zone get example.com --json | jq -r '.records[]'

Use rr zone list --name, --managed, --unmanaged, or --service when you need discovery or narrowing.

Monitor Expiring Domains

rr domain list --expiring-within 30 --json | jq '.[].domainName'

Parsing JSON Output

# Get all domain names
rr domain list --json | jq -r '.[].domainName'

# Check if available
rr domain check example.com --json | jq -r '.available'

# Filter by status
rr domain list --json | jq '.[] | select(.status=="active")'

Error Handling

Common fixes:

• not authenticated → rr auth login
• customer not configured → rr config set customer <handle>
• rate limited → Wait and retry, or use bulk endpoints

Environment Variables

Scripting Tips

# Skip confirmation prompts
rr domain delete example.com -y

Installation

brew install dedene/tap/rr