CLI Alert Commands
These commands let you list, respond to, and resolve alerts.
List alerts
Section titled “List alerts”beeps alert listbeeps alert list --activebeeps alert list --resolved --json| Flag | Description |
|---|---|
--active |
Show only active (unresolved) alerts |
--resolved |
Show only resolved alerts |
Get alert details
Section titled “Get alert details”beeps alert get --alert-id alt_abc123beeps alert get --alert-id alt_abc123 --jsonRespond to an alert
Section titled “Respond to an alert”Mark yourself as responding
Section titled “Mark yourself as responding”Signal to your team that you’re looking at an alert:
beeps alert on-it --alert-id alt_abc123By default this marks the access token owner as responding. To mark a different user:
beeps alert on-it --alert-id alt_abc123 --user-id usr_def456Assign an alert
Section titled “Assign an alert”Assign an alert to a specific user:
beeps alert assign --alert-id alt_abc123 --user-id usr_def456Finish or hand back an alert
Section titled “Finish or hand back an alert”When your work is complete, mark it done (optionally linking the fix):
beeps alert done --alert-id alt_abc123beeps alert done --alert-id alt_abc123 --pr-url https://github.com/org/repo/pull/42If you can’t handle the alert, drop it — if you were the last active responder on an unresolved alert, beeps clears the acknowledgment and re-arms escalation from the top, so the alert never sits abandoned:
beeps alert drop --alert-id alt_abc123Both auto-detect your responder record when only one human is active; pass --responder-id otherwise (beeps alert responders lists them).
List responders
Section titled “List responders”See who is currently responding to an alert:
beeps alert responders --alert-id alt_abc123beeps alert responders --alert-id alt_abc123 --jsonList notifications
Section titled “List notifications”See every notification beeps attempted for an alert and whether it was delivered — delivered means the carrier confirmed receipt (SMS), failed includes the reason:
beeps alert notifications --alert-id alt_abc123beeps alert notifications --alert-id alt_abc123 --jsonInvestigate
Section titled “Investigate”Get fix context
Section titled “Get fix context”Get the source payload, related deploys, and prior incidents for an alert:
beeps alert fix-context --alert-id alt_abc123beeps alert fix-context --alert-id alt_abc123 --jsonList agent jobs
Section titled “List agent jobs”See AI agent jobs (Devin, Cursor) that are working on an alert:
beeps alert agents --alert-id alt_abc123beeps alert agents --alert-id alt_abc123 --jsonResolve an alert
Section titled “Resolve an alert”beeps alert resolve --alert-id alt_abc123Exit Codes
Section titled “Exit Codes”0success1validation failure or API error