whoop-cli

Simple WHOOP command-line tool for humans and agents.

npm install -g @andreasnlarsen/whoop-cli

Terminal

$ whoop summary --json --pretty
{
  "data": {
    "recoveryScore": 84,
    "hrv": 68.4,
    "restingHr": 52,
    "sleepPerformance": 91,
    "cycleStrain": 9.8,
    "recentActivities": 3,
    "recentStructuredActivities": 2,
    "recentGenericActivities": 1
  },
  "error": null
}

Example of a summary.

Questions

How do I start it?

Create your own app at developer-dashboard.whoop.com. Run whoop auth login and paste its client ID, client secret and redirect URI.

The README has every step.

Is this made by WHOOP?

No. It's unofficial and not affiliated with Whoop, Inc. WHOOP is their trademark.

Why do I need my own WHOOP app?

There's no shared login service. The tool talks only to WHOOP.

What can it show?

Recovery, sleep, cycles, activities and your profile. whoop summary and whoop day-brief give you the day.

How do agents use it?

Add --json to any command. The answer is always {data, error}.

whoop skill install adds a ready-made agent skill.

Where are my tokens kept?

In Keychain on a Mac. In 1Password on Linux and Windows. A Linux server can opt into a local file.

What does it need?

Node.js with npm. A WHOOP account. Runs on macOS, Linux and Windows.

“whoop-cli: command not found”

The command is whoop.

How do I update or remove it?

Update with npm install -g @andreasnlarsen/whoop-cli@latest.

Remove with whoop auth logout, then npm uninstall -g @andreasnlarsen/whoop-cli.