@uptrack/cli

Manage Uptrack monitors, incidents and integrations from the terminal.

npm install -g @uptrack/cli

Requires Node 18+. No runtime dependencies.

Authenticate

Get a token from https://uptrack.site/settings, then:

uptrack auth                 # prompts, input is masked
uptrack auth status          # who am I, which instance
uptrack auth logout

The token is written to ~/.config/uptrack/config.json with mode 0600. UPTRACK_TOKEN and UPTRACK_URL override it, which is what you want in CI:

UPTRACK_TOKEN=$TOKEN uptrack monitors list --json

Self-hosted instance:

uptrack auth --url https://uptrack.internal.example.com

Monitors

uptrack monitors list
uptrack monitors get 7
uptrack monitors check
uptrack monitors create website --name "My Site" --url https://example.com --interval 300

Types: website, api, server, service, endpoint, port, heartbeat. Creating a heartbeat monitor prints the heartbeat URL to ping.

Incidents

uptrack incidents list
uptrack incidents get 3
uptrack incidents open --title "Payments degraded" --severity high
uptrack incidents resolve 3

Integrations

uptrack integrations list
uptrack integrations test namecheap
uptrack integrations sync cloudflare

Providers: namecheap, contabo, coolify, telegram, github, cloudflare, backup.

Scripting

Every command takes --json (-j) and exits non-zero on failure, so it pipes into jq:

uptrack monitors list --json | jq -r '.[] | select(.status != "operational") | .name'

License

MIT