@braid-cloud/cli 0.1.5 → 0.1.8

package/LICENSE

@@ -1,8 +1,8 @@
-Braid Proprietary License
+braid Proprietary License
 Copyright (c) 2026 braid ai labs, LLC All rights reserved.
 
 Permission is hereby granted to use this software for its intended purpose
-(installing and managing Braid rules in your development environment).
+(installing and managing braid rules in your development environment).
 
 You MAY NOT:
 - Copy, reproduce, or redistribute the software or its source code

package/README.md

@@ -1,10 +1,12 @@
 # @braid-cloud/cli
 
-Install [Braid](https://braid.cloud) prompts as local files for your AI coding agents.
+Install [braid](https://braid.cloud) prompts as local files for your AI coding agents, and configure braid MCP endpoints in supported tools.
 
 ## What It Does
 
-Syncs your Braid prompts to local files that AI coding agents automatically pick up. Works with 30+ agents including Claude Code, Cursor, GitHub Copilot, and more. Once installed, skills work offline.
+Syncs your braid prompts to local files that AI coding agents automatically pick up. Works with 35+ agents including Claude Code, Cursor, GitHub Copilot, and more. Once installed, skills work offline.
+
+Also configures braid MCP in supported tools by writing the right config entry format for each interface (for example standard JSON, typed stdio entries, Zed nested command blocks, and VS Code extension-specific MCP files).
 
 ## Quick Start
 
@@ -20,13 +22,24 @@ braid install --profile coding-standards
 
 # View installed skills
 braid list
+
+# Configure MCP for a tool
+braid mcp --tool claude-code --no-auth -y
 ```
 
 ## Commands
 
 ### `braid auth`
 
-Authenticate with your Braid account. Runs interactive login by default.
+Authenticate with your braid account. Runs interactive login by default.
+
+During login, the CLI now walks you through:
+
+1. Signing in with your API key
+2. Launching an interactive scope wizard
+3. Selecting organization/profile/projects with name + ID context
+
+Scope defaults are saved to `braid.user.json` so `braid install` can run without repeatedly passing context flags.
 
 ```bash
 braid auth              # Interactive login (alias for `braid auth login`)
@@ -34,11 +47,13 @@ braid auth status       # Check auth status
 braid auth logout       # Remove stored credentials
 ```
 
+After a successful login, `braid auth` offers to run `braid scope --file user` so you can pick your defaults from live org/project/profile data.
+
 The `login` subcommand accepts:
 
 | Flag                 | Description                                   |
 | -------------------- | --------------------------------------------- |
-| `-s, --server <url>` | Braid server URL (for review apps, local dev) |
+| `-s, --server <url>` | braid server URL (for review apps, local dev) |
 
 ### `braid install`
 
@@ -96,6 +111,33 @@ braid list              # Project-local skills
 braid list --global     # Global skills only
 ```
 
+### `braid scope`
+
+Interactively choose scope and write either `braid.user.json` or `braid.json`.
+
+```bash
+braid scope                         # Prompt for target file + scope choices
+braid scope --file user             # Force write to braid.user.json
+braid scope --file project          # Force write to braid.json
+braid scope --server http://localhost:3211
+
+# Non-interactive (script-friendly)
+braid scope --file user --organization personal --source profile --profile default
+braid scope --file project --organization organization --source manual --projects proj_a,proj_b --include-org-global
+braid scope --file user --organization personal --source manual --projects proj_a --rule-ids rule_1,rule_2
+```
+
+Wizard flow:
+
+1. Choose config target (`braid.user.json` or `braid.json`)
+2. Choose organization context (personal or organization)
+3. Choose source (`profile` or `manual`)
+4. In manual mode: choose global toggles, optional project scopes, optional rule include/exclude filters
+5. Select profile/projects/rules by name (with ID hints)
+
+Manual mode supports combining global + project scopes together (not either/or).
+When you belong to multiple orgs, the wizard lets you pick which org's projects to browse.
+
 ### `braid update`
 
 Update installed skills to latest versions. Alias: `braid up`
@@ -117,6 +159,41 @@ braid remove --all              # Remove all skills
 braid remove --global           # Global only
 ```
 
+### `braid mcp`
+
+Configure braid MCP entries in tool-specific MCP config files.
+
+`braid mcp` supports:
+
+- Adding/updating a braid MCP entry for a tool
+- Removing only the braid MCP entry while preserving other MCP servers
+- Status scanning across project/global MCP config locations
+- Optional token embedding and custom MCP URL overrides
+
+```bash
+braid mcp                                 # Interactive MCP setup
+braid mcp --tool claude-code              # Configure a specific tool
+braid mcp --tool cursor --global          # Write global config
+braid mcp --tool claude-code --token br_xxx
+braid mcp --tool claude-code --server https://custom.braid.cloud
+braid mcp --status                        # Show configured tools
+braid mcp --remove --tool claude-code     # Remove braid MCP entry
+```
+
+**Options:**
+
+| Flag                 | Description                               |
+| -------------------- | ----------------------------------------- |
+| `-t, --tool <name>`  | Tool to configure                         |
+| `-g, --global`       | Use global config instead of project      |
+| `--token <token>`    | Embed `BRAID_TOKEN` in MCP entry env      |
+| `--no-auth`          | Skip token prompt / embedding             |
+| `--scope`            | Run interactive scope wizard during setup |
+| `--remove`           | Remove braid MCP entry                    |
+| `--status`           | List tools currently configured for MCP   |
+| `-y, --yes`          | Skip confirmation prompts                 |
+| `-s, --server <url>` | Set `BRAID_MCP_URL` in MCP entry env      |
+
 ## Configuration
 
 ### Token Resolution
@@ -147,26 +224,33 @@ For teams, use two config files in your project root:
 
 ```json
 {
-  "token": "br_your_personal_token"
+  "token": "br_your_personal_token",
+  "profile": "coding-standards"
 }
 ```
 
 This lets teams share configuration while each developer uses their own token.
+`braid auth` can create/update this file for you through its onboarding wizard.
 
 ### All Config Options
 
 Both `braid.json` and `braid.user.json` support these fields. Values in `braid.user.json` override `braid.json`.
 
-| Field               | Type     | Description                                   |
-| ------------------- | -------- | --------------------------------------------- |
-| `token`             | string   | Personal Access Token                         |
-| `serverUrl`         | string   | Server URL (default: `https://braid.cloud`)   |
-| `profile`           | string   | Default profile                               |
-| `orgProjects`       | string[] | Organization project IDs                      |
-| `personalProjects`  | string[] | Personal project IDs                          |
-| `includeUserGlobal` | boolean  | Include user's global prompts (default: true) |
-| `includeOrgGlobal`  | boolean  | Include org's global prompts (default: true)  |
-| `agents`            | string[] | Target agents                                 |
+| Field               | Type     | Description                                           |
+| ------------------- | -------- | ----------------------------------------------------- |
+| `token`             | string   | Personal Access Token                                 |
+| `serverUrl`         | string   | Server URL (default: `https://braid.cloud`)           |
+| `skills.serverUrl`  | string   | Skills endpoint override (alternative to `serverUrl`) |
+| `org`               | string   | Default organization ID                               |
+| `profile`           | string   | Default profile                                       |
+| `orgProjects`       | string[] | Organization project IDs                              |
+| `personalProjects`  | string[] | Personal project IDs                                  |
+| `ruleIds`           | string[] | Include only specific rule IDs                        |
+| `excludedRuleIds`   | string[] | Exclude specific rule IDs                             |
+| `resolveOverlays`   | boolean  | Resolve overlay prompts from server                   |
+| `includeUserGlobal` | boolean  | Include user's global prompts (default: true)         |
+| `includeOrgGlobal`  | boolean  | Include org's global prompts (default: true)          |
+| `agents`            | string[] | Target agents                                         |
 
 ### Environment Variables
 
@@ -194,7 +278,7 @@ Skills are installed to agent-specific directories. The CLI auto-detects install
 | Roo Code       | `.roo/skills/`      | `~/.roo/skills/`              |
 
 <details>
-<summary>All 30+ supported agents</summary>
+<summary>All supported agents</summary>
 
 | Agent         | Project Path           | Global Path                            |
 | ------------- | ---------------------- | -------------------------------------- |
@@ -239,6 +323,22 @@ Some agents also receive rules (always-on standards) in addition to skills. The
 | Cline          | Appended       | `.clinerules`                     |
 | Windsurf       | Appended       | `.windsurfrules`                  |
 
+### MCP Support
+
+Most supported tools now expose MCP config targets. `braid mcp` writes the braid entry to the correct root key and entry shape for each tool.
+
+Common examples:
+
+| Tool           | Project Config       | Global Config                                          |
+| -------------- | -------------------- | ------------------------------------------------------ |
+| Claude Code    | `.mcp.json`          | —                                                      |
+| Cursor         | `.cursor/mcp.json`   | `~/.cursor/mcp.json`                                   |
+| GitHub Copilot | `.vscode/mcp.json`   | —                                                      |
+| OpenCode       | `.opencode/mcp.json` | `~/.config/opencode/mcp.json`                          |
+| Cline          | —                    | VS Code extension settings (`cline_mcp_settings.json`) |
+| Roo Code       | —                    | VS Code extension settings (`mcp_settings.json`)       |
+| Zed            | —                    | `~/.config/zed/settings.json`                          |
+
 ## Skill Format
 
 Installed skills are directories with a `SKILL.md` file:
@@ -278,8 +378,8 @@ Installed skills are tracked in `.braidskills-metadata.json` for update detectio
 ## Related
 
 - **[@braid-cloud/mcp](https://www.npmjs.com/package/@braid-cloud/mcp)** - Real-time MCP integration (no local files)
-- **[Braid Documentation](https://docs.braid.cloud)** - Full platform docs
-
+- **[braid Website](https://braid.cloud)** - Learn more about braid and sign up for an account.
+- 
 ## License
 
-Proprietary - see [LICENSE](./LICENSE)
+Proprietary - all rights reserved.