Kōdo CLI

Command-line interface for managing your Kōdo status page.

Installation

``bash
npm install -g kodo-cli
`

Or use directly with npx:

`bash
npx kodo-cli --help
`

Quick Start

`bash


Login with your API key (found at /dashboard/api)

kodo login your-api-key-here

View status overview

kodo status

List services

kodo services list

Create an incident

kodo incidents create -t "Database issues" --severity major -m "Investigating slow queries"

Resolve an incident

kodo incidents resolve abc123 -m "Fixed the connection pool configuration"
`

Commands

$3

`bash


Save API key

kodo login
kodo login --url https://your-custom-domain.com

Remove saved credentials

kodo logout

Show current config

kodo whoami
`

$3

`bash


Quick overview of services and incidents


kodo status
`

$3

`bash


List all incidents

kodo incidents list
kodo incidents ls # alias
kodo incidents list --status investigating # filter by status

Create incident

kodo incidents create -t "Title" --severity major
kodo incidents create -t "API down" --severity critical -m "Investigating the issue" --services "API,Database"

Update incident

kodo incidents update -s identified -m "Found the root cause"

Resolve incident

kodo incidents resolve
kodo incidents resolve -m "Deployed fix"

Get incident details

kodo incidents get

Delete incident

kodo incidents delete --force
`

$3

`bash


List all services

kodo services list
kodo services ls # alias

Create service

kodo services create -n "API Gateway" -d "Main API service"

Update service status

kodo services status "API" degraded
kodo services status maintenance

Quick status shortcuts

kodo services up "API" # Set to operational
kodo services down "API" # Set to major_outage

Delete service

kodo services delete --force
`

$3

`bash


Simple heartbeat ping

kodo heartbeat
kodo hb # alias

With status details

kodo heartbeat --status up --time 1523 --message "Backup completed"
`

Environment Variables

| Variable | Description |
|----------|-------------|
| KODO_API_KEY | API key (overrides saved config) |
| KODO_API_URL | API base URL (default: https://kodo.dev) |

CI/CD Integration

$3

`yaml
- name: Create incident on failure
if: failure()
run: npx kodo-cli incidents create -t "Deploy failed" --severity major
env:
KODO_API_KEY: ${{ secrets.KODO_API_KEY }}
`

$3

`bash


Add to crontab


0 /usr/local/bin/backup.sh && npx kodo-cli heartbeat my-backup-monitor
``

License

MIT