Kōdo CLI

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

Installation

npm install -g kodo-cli

Or use directly with npx:

npx kodo-cli --help

Quick Start

# 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

Authentication

# Save API key
kodo login <api-key>
kodo login <api-key> --url https://your-custom-domain.com

# Remove saved credentials
kodo logout

# Show current config
kodo whoami

Status Overview

# Quick overview of services and incidents
kodo status

Incidents

# 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 <id> -s identified -m "Found the root cause"

# Resolve incident
kodo incidents resolve <id>
kodo incidents resolve <id> -m "Deployed fix"

# Get incident details
kodo incidents get <id>

# Delete incident
kodo incidents delete <id> --force

Services

# 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 <service-id> maintenance

# Quick status shortcuts
kodo services up "API"     # Set to operational
kodo services down "API"   # Set to major_outage

# Delete service
kodo services delete <id> --force

Heartbeat

# Simple heartbeat ping
kodo heartbeat <monitor-id>
kodo hb <monitor-id>        # alias

# With status details
kodo heartbeat <monitor-id> --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://kodostatus.com) |

CI/CD Integration

GitHub Actions

- 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 }}

Cron Job Heartbeat

# Add to crontab
0 * * * * /usr/local/bin/backup.sh && npx kodo-cli heartbeat my-backup-monitor

License

MIT