Your health coach
lives in the terminal.

Every other health app shows you your numbers. Lumen tells you what to do about them — using your real Garmin data, running locally on your machine.

See it in action

Requires Node.js 22+ · Garmin Connect or WHOOP account

lumen — zsh
lumen · garmin · synced 2m ago

Up and running in minutes

No account needed. No subscription. Your data never leaves your machine unless you want it to.

01

Install

One command. Your AI coach is running in under a minute.

npm install -g lumen-health
lumen setup
02

Connect your device

Link your Garmin or WHOOP. All biometric data syncs directly to your machine.

lumen link garmin
lumen sync
03

Talk to your coach

Ask anything. Get a direct answer based on your actual biometric data.

lumen ask "am I ready to
train hard today?"

Ask the question you actually have

Your Garmin already knows a lot. Lumen puts words to it — in plain English, not graphs.

"Am I ready to train hard today?"

Looks at your HRV, last night's sleep, and recovery trend. Gives you a straight answer, not a dashboard to interpret yourself.

"Why have I been so tired this week?"

Pulls together sleep stages, body battery, and training load across the week and tells you what's actually dragging you down.

"Is my body fighting something?"

Elevated resting HR and tanking HRV often show up 1–2 days before you feel sick. Lumen flags it early so you can act on it.

"Am I overtraining?"

Watches your strain-to-recovery ratio day over day. Tells you when you're digging a hole before you're already in it.

"What should I do today?"

Builds a daily plan around your actual numbers — morning readiness check, what to do at the gym, and how to set up a good night's sleep.

"Am I on track for my goals?"

Set a target — run a faster 5k, sleep 8 hours, keep recovery above 67. Lumen tracks it and tells you where you're slipping.

Every view you need

Six commands. Each one answers a real question athletes ask every morning.

lumen status

Today's full dashboard — recovery, sleep stages, HRV, and activity at a glance.

lumen ask "..."

Your AI coach. Ask anything — get a real answer grounded in your biometric data.

lumen recovery

7-day recovery trend with HRV, RHR, and sleep averages. See the pattern over time.

lumen goals

Set training and recovery targets. Track streaks and progress automatically.

lumen plan

AI-generated daily plan with training priority and evening optimization guidance.

lumen history

Last 7 days of sleep, recovery, HRV, and activity in a single clean table.

Your health data stays on your machine

Health data is sensitive. Lumen stores everything locally in SQLite and never phones home. You control where it goes.

Stored locally in SQLite

Every sleep score, HRV reading, and recovery number lives in a SQLite file on your machine. No cloud, no login, no syncing you didn't ask for.

Names stripped before AI sees it

Before any data reaches a cloud AI provider, personal identifiers are redacted. You can audit exactly what gets sent — it's all open source.

Works fully offline with Ollama

Run a local model with Ollama and nothing ever leaves your device. Cloud AI (Anthropic, OpenAI) is there if you want it — not required.

MIT licensed and open source

Every line of code is on GitHub. No black boxes, no hidden telemetry. Fork it, audit it, run your own version.

Works with your device

You're already wearing the thing and collecting the data. Lumen is just the part that tells you what it actually means.

Garmin Connect

Sleep, HRV, RHR, body battery, stress, steps, calories, and more.

WHOOP coming soon

Recovery score, strain, sleep performance, and respiratory rate.

Stop guessing.
Your data knows the answer.

Your Garmin has been collecting this stuff for months. It's time to actually use it.

Requires Node.js 22+ · MIT License · Open Source