Skip to content

Terminal

beeps terminal is a keyboard-driven live dashboard: active alerts, alert details with notification delivery status, and your on-call roster — designed to be left up in a pane.

It ships with the CLI. The renderer runs on bun, so install that once if you don’t have it:

Terminal window
curl -fsSL https://bun.sh/install | bash

Then:

Terminal window
npm install -g @beepsdev/cli
beeps login
beeps terminal

Authentication comes from your beeps login session (or BEEPS_ACCESS_TOKEN), like every other CLI command. Refresh cadence is --refresh-interval <ms> (default 20000).

The dashboard has a 3-panel layout that adapts to your terminal size:

┌──────────────────────┬──────────────────────┐
│ │ │
│ Active Alerts │ Alert Detail │
│ │ │
│ (scrollable list ├──────────────────────┤
│ of all active │ │
│ alerts) │ On-Call Roster │
│ │ │
└──────────────────────┴──────────────────────┘
  • Left pane — scrollable list of active alerts with status, severity, source, and assignment info. Updates automatically.
  • Top-right pane — press enter on an alert to expand its full detail — status, severity, timestamps, responders, and each notification’s delivery status.
  • Bottom-right pane — on-call roster showing who’s on-call for each schedule, their active alert count, shift end time, and who’s up next.
Key Action
/ Navigate alerts
enter Expand alert detail
escape Collapse detail
a Mark yourself on it
r Resolve alert
e Escalate — pick a member to assign
q / ctrl+c Quit