@betterness/cli 1.1.2 → 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