whoo

Minimal CLI to authenticate against the WHOOP API and inspect WHOOP data from the terminal.

What it does

• One-time OAuth login with browser callback on localhost
• Stores token + client credentials in your OS config directory
• Reuses and refreshes token automatically
• Fetches WHOOP data by command:
  • overview: profile + cycle history with per-cycle recovery/sleep
  • recovery: recovery history
  • sleep: sleep history
  • user: profile + body measurements
• Supports human-readable output and raw JSON (--json)

Prerequisites

1. Node.js 18+ (for npm installs)
2. Bun 1.3+ (for development/publishing in this repo)
3. A WHOOP developer app in the WHOOP developer portal
4. Redirect URI configured in your WHOOP app:
   • http://127.0.0.1:8123/callback

Install globally

With npm:

npm i -g @luisgot/whoo

With Bun:

bun add -g @luisgot/whoo

Then run:

whoo --version
whoo help

Development

Install dependencies:

bun install

Run locally:

bun run src/index.ts help

Build the Node CLI bundle used for publishing:

bun run build
node ./bin/whoo.js --version

Commands

whoo help

Login

whoo login

whoo login always prompts for client_id and client_secret interactively.

For SSH/headless setups where localhost callback is not reachable, use manual mode:

whoo login --manual

Overview

whoo overview
whoo overview --limit 7
whoo overview --json
whoo overview --limit 7 --json

Recovery

whoo recovery
whoo recovery --limit 14

Sleep

whoo sleep
whoo sleep --limit 14

User

whoo user

Status

whoo status

Logout

whoo logout

Config path

Config is written to:

• Linux: ~/.config/whoo/config.json
• macOS: ~/Library/Application Support/whoo/config.json
• Windows: %AppData%/whoo/config.json