agent-incident
incident.io triage CLI for AI agents
- Language
- Go
- Version
- 0.16.1
- License
- PolyForm Perimeter 1.0.0
- Category
- CLI Tool
An incident.io CLI shaped around triage rather than administration — incidents, alerts, actions, follow-ups, on-call schedules and overrides, escalations and status pages, plus the reference data that makes them readable. Compact projections that fit a context window, cursor pagination handled for you, and classified errors so an agent can self-correct.
Features
Triage-shaped, not admin-shaped — the commands incident response needs, not 165+ incident.io API endpoints
Compact by default — an incident comes back as id, name, status, severity, created_at and lead until you ask for --full
Flexible incident ids — INC-2000, 2000 or a UUID all work, and get takes several at once
Item-level misses do not lose the batch — an unresolvable id becomes an @unresolved line on stdout with exit 0; only auth and network failures exit non-zero
Errors classify themselves — fixable_by: agent means fix your parameters, human means stop and ask, retry means wait
Cursor pagination handled automatically, so a list is a list rather than a paging exercise
On-call in full — schedules, who is on now, entries over a window, overrides, escalation paths and creating an escalation
Status pages and their updates, for the part of an incident customers see
Reference data alongside — severities, statuses, roles, users, custom fields, timestamps and the catalog
Keys never touch argv — --form opens a native OS dialog, or pipe the key on stdin; INCIDENT_API_KEY also works with no setup
Multi-org — several incident.io organizations side by side, selected with --org
Self-documenting — agent-incident usage, and a usage page per command group
Single compiled Go binary — no runtime dependencies
Install
Homebrew
$ brew install shhac/tap/agent-incident AI Agent Skill
$ npx skills add shhac/agent-skills --skill agent-incident --global 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. Set it up without the key reaching the command line — a pasted secret on --api-key lands in argv, shell history and the agent transcript.
01 · Add an organization through a native dialog
$ agent-incident auth add prod --form The key is typed straight into the OS, so the agent driving the CLI never sees it.
02 · Or pipe it, for CI and headless hosts
$ printf '%s' "$KEY" | agent-incident auth add prod Keeps the secret off argv. INCIDENT_API_KEY works directly too, with no setup at all.
03 · Check the credential
$ agent-incident auth check Add more organizations the same way and select one per command with --org, or set a default.
04 · See what is active
$ agent-incident incident list --status active Compact NDJSON. agent-incident usage prints the reference card; each command has its own usage page.
Usage
$ agent-incident incident list --status active $ agent-incident incident get INC-2000 $ agent-incident alert list --status firing $ agent-incident oncall schedule entries SCHEDULE_ID --from now --to now+1h $ agent-incident oncall escalation create --incident INC-2000 --path PATH_ID $ agent-incident follow-up list $ agent-incident status-page update list $ agent-incident ref severity list