Documentation Index
Fetch the complete documentation index at: https://docs.larm.dev/llms.txt
Use this file to discover all available pages before exploring further.
The Larm CLI lets you manage monitors, alerts, status pages, disruptions, and webhooks from your terminal. Open source at github.com/larmhq/larm-cli.
Install
brew install larmhq/tap/larm
Download from GitHub Releases. go install github.com/larmhq/larm-cli@latest
Authenticate
Browser login (recommended)
Opens your browser for OAuth. Enter the code shown in your terminal, pick your organization, and approve.
API key
larm auth login --with-token
Paste an API key from Settings > API Keys. Or set the LARM_API_KEY environment variable.
Usage
Monitors
larm monitors list
larm monitors show <id>
larm monitors create --name "API" --url https://example.com
larm monitors update <id> --name "New Name"
larm monitors delete <id>
Monitor stats
larm monitors state <id>
larm monitors uptime <id> --range 7d
larm monitors response-times <id>
larm monitors cert <id>
Alert channels
larm alerts list
larm alerts show <id>
larm alerts create --name "Slack" --type slack --config '{"webhook_url":"..."}'
Status pages
larm status-pages list
larm status-pages show <id>
larm status-pages create --name "Acme Status" --slug acme-status
larm components list --status-page-id <id>
Disruptions
larm disruptions list
larm disruptions show <id>
larm disruptions create --title "API outage" --impact critical --message "Investigating"
larm disruptions update <id> --status resolved
Webhooks
larm webhooks list
larm webhooks create --url https://example.com/hook --events monitor.state_changed
Raw API access
larm api GET /monitors
larm api GET /monitors --field check_type=http
larm api POST /monitors --field name=Test --field check_type=http
Table output in a terminal, JSON when piped.
larm monitors list # table
larm monitors list --output json # JSON
larm monitors list --output json --jq '.[].name' # JQ filter
larm monitors list --fields name,check_type # select columns
Other flags
| Flag | Description |
|---|
--quiet | Suppress output on success |
--dry-run | Print request without sending |
--yes | Skip delete confirmation prompts |
--output json | Force JSON output |
--fields | Select columns for table output |
--jq | Filter JSON output with JQ expressions |
For LLM agents
The CLI has a describe command for machine discovery:
larm describe # full command schema as JSON
larm describe monitors.list # single command schema
Always use --output json for machine-readable output.
Source
The CLI is open source: github.com/larmhq/larm-cli