CLI Reference
Every tch command.
The CLI mirrors the API one-to-one. Most customers use the API directly; the CLI is here for quick checks, scripting, and local development.
Source resolution works the same everywhere: alias → full UUID → short UUID (first 8 chars) → canonical URL. Use whichever is convenient.
Bootstrap & Auth
| tch signup | Create account, write config, print API key once |
| tch login | Authenticate, write JWT + config |
| tch verify <code> | Verify email with the 6-digit code |
| tch verify --resend | Request a new verification code |
| tch whoami | Show current identity and workspace |
Subscribe
| tch subscribe <url> [--alias name] | Start monitoring a spec |
| tch subscribe-file <source> <path> | Subscribe from a local file |
Sources & Versions
| tch sources [--all] | List sources (--all = owner cross-workspace view) |
| tch alias <source> <alias> | Set a human-friendly name |
| tch status [--all] | Cross-source summary |
| tch versions <source> [--limit N] | List stored versions |
| tch view <source> [version] | View a stored spec |
| tch delete <source> [version_id] | Delete a source, or one version |
Diffs
| tch diffs <source> [--limit N] | List stored diffs |
| tch diff <source> <v1> <v2> | Diff two versions (computes on demand if not stored) |
| tch show-diff <diff_id> | Show a stored diff by UUID |
API Keys
| tch keys create <name> | Create a new API key |
| tch keys list | List keys (alias: ls) |
| tch keys revoke <key_id> | Revoke a key |
Polling & Webhooks
| tch poll enable / disable <source> | Toggle polling |
| tch poll set-interval <source> <interval> | e.g. 60, 30m, 2h, 1d |
| tch poll add-webhook <source> <url> | Add a delivery target |
| tch poll list-webhooks <source> | List webhooks on a source |
| tch poll test-webhook <source> | Fire a test delivery |
| tch poll status [source] | Show polling health |
Notifications
| tch notify add-email <source> <email> | Add an email recipient |
| tch notify list-emails <source> | List recipients |
| tch notify set-trigger <source> <email> <breaking|any_change> | Set notification threshold |
Members & Invites
| tch members list | List account members |
| tch invite send <email> [--role] | Invite someone to a workspace |
| tch accept-invite <token> | Accept a pending invite |
| tch audit [--limit N] | View recent audit log entries |
Workspaces
| tch workspace create <name> | Create a new workspace |
| tch workspace list | List workspaces |
| tch workspace list-members [workspace] | List members |
| tch workspace delete <name> [--force] | Delete a workspace |