Problem
A new Oura user can install the CLI but may not reach a useful first result. The current flow has two critical gaps:
oura-cli login uses a visible terminal prompt for a sensitive Personal Access Token.
- Local commands on a new or empty database render blank score tables rather than explaining that a sync is required.
Goal
A first-time user should securely connect their account and understand the next action at every expected state.
Scope
First increment
Follow-up
Acceptance criteria
- Interactive token characters are not echoed to the terminal.
- An empty
report tells the user why no insight is available and gives the exact next command.
- Tests cover the new first-run behaviour.
- Existing machine-readable output and non-interactive authentication remain compatible.
Out of scope
Changing Oura API coverage, storage format, or the package distribution model.
Problem
A new Oura user can install the CLI but may not reach a useful first result. The current flow has two critical gaps:
oura-cli loginuses a visible terminal prompt for a sensitive Personal Access Token.Goal
A first-time user should securely connect their account and understand the next action at every expected state.
Scope
First increment
login --tokenbehavior for scripts.oura-cli reportwith a next-step command.Follow-up
db todayanddb week.setupordoctorflow that validates the token and guides the first sync.Acceptance criteria
reporttells the user why no insight is available and gives the exact next command.Out of scope
Changing Oura API coverage, storage format, or the package distribution model.