agent-incident

incident.io triage CLI for AI agents

Language
Go
Version
0.3.1
License
MIT
Category
CLI Tool
View on GitHub

An incident.io CLI designed for AI agent triage workflows — incidents, alerts, on-call schedules, escalations, and status pages. Structured output with classified errors so agents can self-correct, and multi-org support for switching between organizations.

Features

01

Token-efficient output — NDJSON for lists, JSON for single items, YAML available

02

Structured error classification — every error includes fixable_by: agent|human|retry

03

Triage-focused — incidents, alerts, on-call, escalations, and status pages

04

Multi-org support — switch between incident.io organizations with --org

05

Self-documenting — agent-incident llm-help for agent-friendly reference

06

Single compiled Go binary — no runtime dependencies

Install

Homebrew

>_ 
$ brew install shhac/tap/agent-incident

AI Agent Skill

>_ 
$ npx skills add shhac/agent-incident

GitHub Release (macOS)

>_ 
$ curl -L https://github.com/shhac/agent-incident/releases/latest/download/agent-incident-darwin-arm64.tar.gz | tar xz

Go Install

>_ 
$ go install github.com/shhac/agent-incident/cmd/agent-incident@latest

Build from Source

>_ 
$ git clone https://github.com/shhac/agent-incident.git && cd agent-incident && make build

Getting Started

agent-incident needs an incident.io API key before it can query anything. Store credentials per organization for easy multi-org switching.

01 · Add your organization

>_ 
$ agent-incident auth add prod --api-key YOUR_API_KEY

Keys are stored in macOS Keychain when available.

02 · Test the connection

>_ 
$ agent-incident auth check

03 · List incidents

>_ 
$ agent-incident incident list

Returns NDJSON by default for token-efficient streaming.

Usage

>_ List active incidents 
$ agent-incident incident list
>_ Get incident details 
$ agent-incident incident get INC-123
>_ Check who's on call 
$ agent-incident oncall schedule list
>_ List alerts 
$ agent-incident alert list
>_ View status pages 
$ agent-incident status-page list
>_ Escalate to responders 
$ agent-incident oncall escalation create --path engineering