@betterness/cli 1.1.2 → 1.3.0

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
@@ -145,6 +172,30 @@ betterness workflow daily-brief       # Full health snapshot
 betterness workflow next-actions      # AI-driven recommendations
 ```
 
+### MCP Integration
+
+One-command setup for the [Betterness MCP server](https://www.betterness.ai/mcp) in your AI client:
+
+```bash
+# Install into Claude Desktop, Claude Code, Cursor, or Windsurf
+betterness mcp install claude
+betterness mcp install claude-code
+betterness mcp install claude-code --scope project    # project-level .mcp.json
+betterness mcp install cursor
+betterness mcp install windsurf
+
+# Preview without writing
+betterness mcp install claude --dry-run
+
+# Check status across all clients
+betterness mcp status
+
+# Remove
+betterness mcp uninstall claude
+```
+
+The install command reads your stored credentials, merges the MCP config into the client's config file (preserving existing entries), and creates a `.bak` backup.
+
 ### Schema Discovery
 
 ```bash
@@ -162,6 +213,7 @@ The CLI is designed to be consumed by AI agents. Key features:
 - `betterness schema` for runtime capability discovery
 - `--quiet` mode for exit-code-only checks
 - `--dry-run` on destructive commands for safe planning
+- `betterness mcp install <client>` for one-command MCP setup
 
 ### Skills
 
@@ -184,6 +236,8 @@ Agent skills teach your AI coding agent the Betterness API surface — endpoints
 | [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) |
+| [betterness-health-profile](https://github.com/Betterness/betterness-cli/tree/main/skills/betterness-health-profile) | Health profile questionnaire management |
+| [betterness-mcp](https://github.com/Betterness/betterness-cli/tree/main/skills/betterness-mcp) | MCP server integration for AI clients |
 
 **Persona skills:**