Terminal

beeps-terminal is a keyboard-driven TUI dashboard that gives you a live view of active alerts, alert details, and your on-call roster — all from the terminal.

Installation

npm (global)
npx

npm install -g beeps-terminal

Then run:

beeps-terminal

npx beeps-terminal

Configuration

beeps-terminal needs one environment variable:

Variable	Required	Description
`BEEPS_API_KEY`	Yes	Your API key from organization settings (looks like `bk_xxxxxxxx`)

export BEEPS_API_KEY="bk_your_api_key_here"
beeps-terminal

Layout

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

┌──────────────────────┬──────────────────────┐
│                      │                      │
│   Active Alerts      │   Alert Detail /     │
│                      │   Recent Deploys     │
│   (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 — shows recent deploy activity by default. Press enter on an alert to expand its full detail (ID, status, severity, timestamps, metadata).
Bottom-right pane — on-call roster showing who’s on-call for each schedule, their active alert count, rotation end time, and who’s up next.

Keybindings

Key	Action
`↑` / `↓`	Navigate alerts
`enter`	Expand alert detail
`escape`	Collapse detail
`a`	Acknowledge alert
`r`	Resolve alert
`e`	Escalate alert
`q` / `ctrl+c`	Quit