CLI

The Tallwatch CLI is a thin client over the public REST API. Use it in CI, on your laptop, or to import monitors from UptimeRobot. The control plane stays on Tallwatch — the CLI only calls https://api.tallwatch.com.

Install

macOS / Linux
Windows

Requires Node.js 20+.

curl -fsSL https://tallwatch.com/install-cli.sh | bash

Or with npm:

npm install -g @tallwatch/cli@latest

Requires Node.js 20+ (PowerShell).

irm https://tallwatch.com/install-cli.ps1 | iex

Or with npm:

npm install -g @tallwatch/cli@latest

Verify:

tallwatch --help

Run tallwatch login with no flags. The CLI starts a device session, opens your browser, and polls until you approve.

tallwatch login

The terminal prints a one-time code and opens your browser.
Sign in if needed — approval is automatic when the URL includes your code.
Tallwatch creates an API key and delivers it to the CLI over the short-lived device session.
The browser tab can close. The terminal prints login success.

This works on SSH and remote machines: the browser can run on your laptop while the CLI runs on a server. Use --no-browser to print the URL yourself. The key is saved to ~/.config/tallwatch/config.json (mode 0600 on Unix). On Windows the path is %USERPROFILE%\.config\tallwatch\config.json.

Manual key

Paste a key directly:

tallwatch login --api-key tw_live_your_key_here

Create keys in Settings → API keys, or run tallwatch login to authorize from the terminal.

Environment overrides

Variable	Purpose
`TALLWATCH_API_KEY`	Bearer key (skips config file)
`TALLWATCH_API_URL`	API base URL (default `https://api.tallwatch.com`)
`TALLWATCH_APP_URL`	App URL for browser login (default `https://app.tallwatch.com`)

Use tallwatch login --no-browser when the CLI runs on a remote machine and you open the login URL on your laptop.

Commands

Same surface as the MCP server. Add --json on list, show, and mutating commands for scripting. List --limit max is 15.

Command	What it does
`tallwatch help`	Print usage
`tallwatch login`	Browser device login; stores API key locally
`tallwatch login --api-key tw_live_…`	Log in with an existing API key
`tallwatch whoami`	Show API URL, masked key, and org id
`tallwatch monitor list`	List monitors (optional `--limit`, `--cursor`)
`tallwatch monitor show <id>`	Fetch one monitor and its current state
`tallwatch monitor create --url …`	Create an HTTP monitor
`tallwatch monitor update <id>`	Patch name, interval, regions, or status
`tallwatch monitor pause <id>`	Pause scheduling (`--yes` to skip confirm)
`tallwatch monitor resume <id>`	Resume a paused monitor
`tallwatch incident list`	List incidents (`--status`, `--monitor-id`, `--cursor`)
`tallwatch incident show <id>`	Incident detail, cause, and regions
`tallwatch incident ack <id>`	Acknowledge an open incident (`--note`)
`tallwatch incident resolve <id>`	Manually resolve an incident (`--yes`)
`tallwatch incident postmortem <id>`	Set or clear postmortem (`--md`, `--file`, `--clear`)
`tallwatch oncall now`	Who is on call now (`--schedule-id`)
`tallwatch status-page list`	List status pages in the org
`tallwatch test --url …`	Run one ad-hoc check from the API host
`tallwatch import uptimerobot --file …`	Dry-run UptimeRobot import (`--apply --yes` to write)

Examples:

tallwatch monitor create --url https://api.example.com/healthz --interval 60s
tallwatch monitor pause <uuid> --reason "database migration" --yes
tallwatch incident ack <uuid> --note "looking"
tallwatch incident resolve <uuid> --yes
tallwatch incident postmortem <uuid> --file ./postmortem.md

UptimeRobot import

Export monitors from UptimeRobot, dry-run the mapping, then apply:

curl -X POST https://api.uptimerobot.com/v2/getMonitors \
  -H "Content-Type: application/json" \
  -d '{"api_key":"YOUR_UR_KEY","format":"json"}' \
  > monitors.json

tallwatch import uptimerobot --file ./monitors.json
tallwatch import uptimerobot --file ./monitors.json --apply --yes

Dry-run works without login. --apply requires a signed-in CLI. HTTP (type 1) and keyword (type 2) monitors map to Tallwatch HTTP checks. Ping, port, and heartbeat exports are skipped with a reason.

Auth and limits

The CLI uses the same API keys and rate limits as curl or MCP. Keys need read to list; write to create, pause, or resolve. CLI login creates a key named CLI login with read + write scopes. Revoke it anytime from Settings. API keys. MCP server for AI agents. Install page: tallwatch.com/cli.

Monitors

Alerts

Status pages

Developers

Install

Manual key

Environment overrides

Commands

UptimeRobot import

Auth and limits

​Install

​Sign in

​Manual key

​Environment overrides

​Commands

​UptimeRobot import

​Auth and limits

​Related

Install

Sign in

Manual key

Environment overrides

Commands

UptimeRobot import

Auth and limits

Related