Unofficial CLI for Oura Ring — sleep, readiness, and activity scores from your terminal.
- Get a Personal Access Token from Oura Cloud
- Export it:
export OURA_TOKEN=your_token_here - Install:
cargo install --path .
oura # sleep + readiness + activity scores (today)
oura scores [DATE] # same as above, with optional date
oura sleep [DATE] # detailed sleep breakdown
oura readiness [DATE] # readiness score + contributors
oura activity [DATE] # steps, calories, movement
oura hrv [DATE] # heart rate variability from sleep
oura stress [DATE] # daily stress summary
oura sync [DATE] # sync one night's sleep into DuckDB
oura weekly # this week versus 4-week average from DuckDB
oura trend # 30-day readiness and bedtime trends from DuckDB
oura event <DATE> <LABEL> # compare the 7 days before and after an event
oura json <ENDPOINT> [DATE] # raw JSON for any API endpoint
DATE accepts YYYY-MM-DD, today, or yesterday. Defaults to today.
DuckDB-backed commands store data in /Users/terry/oura-data/data/oura.duckdb.
Run oura sync [DATE] for each night you want to include before using
weekly, trend, or event.
$ oura
Sleep 82 Readiness 79 Activity 91
$ oura readiness
Readiness Score: 79
Temp Deviation: +0.2°C
Activity Balance 85
Body Temperature 100
HRV Balance 75
...
This project is not affiliated with, endorsed by, or connected to Oura Health Oy. "Oura" is a trademark of Oura Health Oy.