WHOOP TUI

Your WHOOP data in the terminal.

A terminal user interface that connects to the WHOOP API and displays your recovery, strain, sleep, and workout data — right from the command line.

Recovery

Score, HRV, resting heart rate, SpO2, skin temperature

Strain

Daily strain score, heart rate, calories, trend charts

Sleep

Stage breakdown, performance, efficiency, sleep need

Workouts

Activity history, HR zones, distance, elevation

Install

git clone https://github.com/Joeavaikath/whoop-tui.git
cd whoop-tui
make build

Setup

Register an app at developer.whoop.com, then run the setup command:

make setup

Or manually create a .env file:

WHOOP_CLIENT_ID=your-client-id
WHOOP_CLIENT_SECRET=your-client-secret

Run

make run

The app will open a browser for OAuth login, then launch the dashboard.

Controls

1-4        Switch views (Today / Week / 30d / 60d)
Tab / ← →  Cycle between views
↑ ↓ / j k  Scroll day list
Enter      Drill into a day
Esc        Back from detail
r          Refresh data
q          Quit
GitHub Privacy Policy