Rootly CLI

Command-line interface for the Rootly incident management platform.

Installation

npm install -g @wyre-technology/rootly-cli

Authentication

Set your Rootly API token as an environment variable:

export ROOTLY_API_TOKEN=your-api-token-here

Usage

The CLI follows the pattern: rootly <resource> <action> [options]

Incidents

# List incidents
rootly incidents list
rootly incidents list --status started
rootly incidents list --severity sev1 --format table

# Get a specific incident
rootly incidents get <incident-id>

# Create an incident
rootly incidents create --title "Database outage" --summary "Primary DB is down"

# Update an incident
rootly incidents update <incident-id> --status mitigated

# Resolve an incident
rootly incidents resolve <incident-id>

Alerts

# List alerts
rootly alerts list
rootly alerts list --status triggered --format table

# Create an alert
rootly alerts create --summary "High CPU usage" --severity critical

# Update an alert
rootly alerts update <alert-id> --status acknowledged

# Acknowledge an alert
rootly alerts acknowledge <alert-id>

# Resolve an alert
rootly alerts resolve <alert-id>

Schedules

# List on-call schedules
rootly schedules list
rootly schedules list --format table

# Get a specific schedule
rootly schedules get <schedule-id>

Organization

# Teams
rootly org teams list
rootly org teams get <team-id>
rootly org teams create --name "Engineering" --description "Engineering team"
rootly org teams update <team-id> --name "Platform Engineering"
rootly org teams delete <team-id>

# Severities
rootly org severities list

# Current user
rootly org user me

Output Formats

By default, all commands output JSON. Use the --format table flag for table output:

rootly incidents list --format table

Development

# Install dependencies
npm install

# Build the CLI
npm run build

# Run in development mode
npm run dev

# Lint
npm run lint

License

MIT

Contributing

See CONTRIBUTING.md for contribution guidelines.