ClouDNS operations CLI

DNS changes agents can inspect before they apply.

CloudNS Tools wraps ClouDNS with predictable commands, dry-run previews, JSON output, and SSH or direct transport for IP-whitelisted accounts.

npm install -g github:urbansheep/cloudns-tools curl -fsSL https://cloudns.urbansheep.com/install.sh | sh
GitHub Agent flow 
$ cloudns preset apply example.com fastmail --dry-run -f json
{
  "action": "preset apply",
  "status": "skipped",
  "recordsAffected": 3
}

$ cloudns preset apply example.com fastmail -f json
{
  "action": "preset apply",
  "status": "ok",
  "recordsAffected": 3
}

Agent-first flow

Check, plan, apply, verify.

01

Check auth

Run cloudns auth check before touching records.

02

Preview writes

Use --dry-run -f json so automation can inspect intended changes.

03

Apply idempotently

Repeated adds and preset applies converge instead of duplicating records.

04

Read stdout safely

JSON output stays clean while verbose diagnostics go to stderr.

Transports

Works from an operator machine or the whitelisted VPS.

SSH mode runs API calls through remote curl on your whitelisted VPS.

Direct mode runs local curl for agents already executing on the VPS.

Secrets are sent through POST data, not command-line arguments.