Skip to main content

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

Authenticate

larm auth login
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

Output formats

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

FlagDescription
--quietSuppress output on success
--dry-runPrint request without sending
--yesSkip delete confirmation prompts
--output jsonForce JSON output
--fieldsSelect columns for table output
--jqFilter 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