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)

npm install -g beeps-terminal

Then run:

beeps-terminal

npx

npx beeps-terminal

Configuration

beeps-terminal needs one environment variable:

Variable	Required	Description
BEEPS_ACCESS_TOKEN	Yes	Your access token from organization settings (looks like bat_xxxxxxxx)

export BEEPS_ACCESS_TOKEN="YOUR_ACCESS_TOKEN"
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