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="bat_your_access_token_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 |