CLI

Kamuptime provides a Go-based CLI tool (kamuptime) for managing monitors, incidents, and more from the terminal.

Installation

Download the latest binary from the releases page or install with Go:

go install github.com/kamuptime/cli/cmd/kamuptime@latest

Configuration

Set your API key as an environment variable or pass it with the --api-key flag:

export KAMUPTIME_API_KEY="km_your_api_key"

Optionally set the base URL (defaults to https://app.kamuptime.com):

export KAMUPTIME_BASE_URL="https://app.kamuptime.com"

Commands

Projects

kamuptime projects list
kamuptime projects get <project-id>
kamuptime projects create --name "Production"
kamuptime projects update <project-id> --name "Production EU"
kamuptime projects delete <project-id>

Monitors

kamuptime monitors list
kamuptime monitors get <monitor-id>
kamuptime monitors create --type http --name "My API" --url "https://api.example.com/health"
kamuptime monitors update <monitor-id> --interval 30
kamuptime monitors delete <monitor-id>
kamuptime monitors stats <monitor-id>
kamuptime monitors daily-uptime <monitor-id> --from 2025-05-01 --to 2025-05-31
kamuptime monitors response-times <monitor-id> --from 2025-05-01 --to 2025-05-31

Alerts

kamuptime channels list
kamuptime channels create --type slack --name "Eng Slack" --config '{"webhookUrl":"https://hooks.slack.com/..."}'
kamuptime channels delete <channel-id>

kamuptime rules list
kamuptime rules create --name "Downtime alert" --monitor <monitor-id> --channel <channel-id> --trigger monitor_down
kamuptime rules delete <rule-id>

kamuptime alert-history --from 2025-05-01 --to 2025-05-31

Incidents

kamuptime incidents list
kamuptime incidents get <incident-id>
kamuptime incidents create --title "API outage" --status investigating --monitor <monitor-id>
kamuptime incidents update <incident-id> --status resolved --message "Issue resolved."
kamuptime incidents delete <incident-id>

Status Pages

kamuptime status-pages list
kamuptime status-pages get <status-page-id>
kamuptime status-pages create --name "Acme Status" --slug acme --monitors mon_abc,mon_def
kamuptime status-pages update <status-page-id> --custom-domain status.example.com
kamuptime status-pages delete <status-page-id>

Billing

kamuptime plans list
kamuptime subscription

Output Formats

Use --output or -o to control output format:

kamuptime monitors list -o json
kamuptime monitors list -o table

Supported formats: table (default), json.

Global Flags

Flag	Description
--api-key	API key (overrides KAMUPTIME_API_KEY)
--base-url	Base URL (overrides KAMUPTIME_BASE_URL)
--output, -o	Output format: table or json
--help, -h	Show help