@betterness/cli 1.1.1 → 1.2.2

package/README.md

@@ -12,6 +12,17 @@ Requires Node.js 20+.
 
 ## Authentication
 
+### OAuth (default)
+
+```bash
+betterness auth login      # Opens browser for OAuth login
+betterness auth whoami     # Verify
+```
+
+The CLI opens a browser window for secure authentication via OAuth. Tokens are stored in `~/.betterness/tokens.json` and refreshed automatically.
+
+### API Key
+
 Get your API key from either:
 
 - [app.betti.bot/settings/betterness-mcp](https://app.betti.bot/settings/betterness-mcp)
@@ -26,7 +37,11 @@ betterness auth whoami   # verify
 
 You can also set the `BETTERNESS_API_KEY` environment variable instead of storing credentials.
 
-Priority: `--api-key` flag > `BETTERNESS_API_KEY` env var > stored credentials.
+### Credential priority
+
+`--api-key` flag > `BETTERNESS_API_KEY` env var > OAuth tokens > stored API key.
+
+Only one auth method is active at a time — logging in with one clears the other.
 
 ## Quick Start
 
@@ -131,6 +146,18 @@ betterness lab-results update-biomarker --biomarker-id <id> --result 5.2 --unit
 betterness lab-results update-metadata --result-id <id> --patient-name "Jane Doe"
 ```
 
+### Health Profile
+
+```bash
+betterness health-profile schema                    # List all sections
+betterness health-profile schema --section HWP      # Questions in a section
+betterness health-profile get                       # Full profile (flat map)
+betterness health-profile get-section --section DA  # Single section answers
+betterness health-profile summary                   # Human-readable summary
+betterness health-profile update --data '{"HWP_HAB_do_you_smoke_cigarettes_or_use_tobacco_products": false}'
+betterness health-profile reset-section --section DA
+```
+
 ### Smart Listings (Wellness Providers)
 
 ```bash
@@ -165,12 +192,40 @@ The CLI is designed to be consumed by AI agents. Key features:
 
 ### Skills
 
-Agent skills teach your AI coding agent the Betterness API surface — endpoints, schemas, and workflows — so it can build integrations without guessing. Available in the [betterness-cli](https://github.com/Betterness/betterness-cli) repo under `.agents/skills/`:
+Agent skills teach your AI coding agent the Betterness API surface — endpoints, schemas, and workflows — so it can build integrations without guessing. Available in the [betterness-cli](https://github.com/Betterness/betterness-cli) repo under [`skills/`](https://github.com/Betterness/betterness-cli/tree/main/skills):
+
+**Core skills:**
+
+| Skill | Description |
+|-------|-------------|
+| [betterness-shared](https://github.com/Betterness/betterness-cli/tree/main/skills/betterness-shared) | Shared CLI setup, auth, and output format patterns |
+| [betterness-auth](https://github.com/Betterness/betterness-cli/tree/main/skills/betterness-auth) | Authentication and credential management |
+| [betterness-profile](https://github.com/Betterness/betterness-cli/tree/main/skills/betterness-profile) | User profile access and updates |
+| [betterness-biomarkers](https://github.com/Betterness/betterness-cli/tree/main/skills/betterness-biomarkers) | Biomarker results and biological age |
+| [betterness-health-data](https://github.com/Betterness/betterness-cli/tree/main/skills/betterness-health-data) | Activity, sleep, vitals, body composition |
+| [betterness-connected-devices](https://github.com/Betterness/betterness-cli/tree/main/skills/betterness-connected-devices) | Wearable device integrations |
+| [betterness-lab-tests](https://github.com/Betterness/betterness-cli/tree/main/skills/betterness-lab-tests) | Lab test catalog and browsing |
+| [betterness-lab-orders](https://github.com/Betterness/betterness-cli/tree/main/skills/betterness-lab-orders) | Lab order scheduling and booking |
+| [betterness-lab-records](https://github.com/Betterness/betterness-cli/tree/main/skills/betterness-lab-records) | Lab record management |
+| [betterness-lab-results](https://github.com/Betterness/betterness-cli/tree/main/skills/betterness-lab-results) | Lab result uploads and updates |
+| [betterness-purchases](https://github.com/Betterness/betterness-cli/tree/main/skills/betterness-purchases) | Purchases and Stripe checkout |
+| [betterness-smart-listings](https://github.com/Betterness/betterness-cli/tree/main/skills/betterness-smart-listings) | Wellness provider search |
+| [betterness-workflow](https://github.com/Betterness/betterness-cli/tree/main/skills/betterness-workflow) | Composite commands (daily brief, next actions) |
+
+**Persona skills:**
+
+| Skill | Description |
+|-------|-------------|
+| [persona-health-coach](https://github.com/Betterness/betterness-cli/tree/main/skills/persona-health-coach) | Health coach persona for wellness guidance |
+| [persona-lab-manager](https://github.com/Betterness/betterness-cli/tree/main/skills/persona-lab-manager) | Lab manager persona for test ordering workflows |
+
+**Recipe skills:**
 
 | Skill | Description |
 |-------|-------------|
-| [biomarkers-api](https://github.com/Betterness/betterness-cli/tree/main/.agents/skills/biomarkers-api) | Biomarkers, lab tests, lab orders, health records, biological age, purchases, Stripe flows |
-| [perks-api](https://github.com/Betterness/betterness-cli/tree/main/.agents/skills/perks-api) | Perks management, browsing, partner profiles, collaboration workflow |
+| [recipe-health-checkup](https://github.com/Betterness/betterness-cli/tree/main/skills/recipe-health-checkup) | Step-by-step health checkup workflow |
+| [recipe-order-lab-test](https://github.com/Betterness/betterness-cli/tree/main/skills/recipe-order-lab-test) | End-to-end lab test ordering |
+| [recipe-track-biomarker](https://github.com/Betterness/betterness-cli/tree/main/skills/recipe-track-biomarker) | Biomarker tracking over time |
 
 #### Installing skills
 
@@ -183,11 +238,11 @@ npx skills add https://github.com/Betterness/betterness-cli
 Or install a specific skill:
 
 ```bash
-npx skills add https://github.com/Betterness/betterness-cli --skill biomarkers-api
-npx skills add https://github.com/Betterness/betterness-cli --skill perks-api
+npx skills add https://github.com/Betterness/betterness-cli --skill betterness-biomarkers
+npx skills add https://github.com/Betterness/betterness-cli --skill persona-health-coach
 ```
 
-Each skill folder contains a `SKILL.md` (activation rules and patterns) and a `references/` directory with full API specs.
+Each skill folder contains a `SKILL.md` with activation rules, patterns, and API reference.
 
 ## Full CLI Reference