@braid-cloud/cli 0.1.6 → 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,16 @@ 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:
 
@@ -48,7 +53,7 @@ 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`
 
@@ -154,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
@@ -196,16 +236,21 @@ This lets teams share configuration while each developer uses their own token.
 
 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
 
@@ -233,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                            |
 | ------------- | ---------------------- | -------------------------------------- |
@@ -278,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:
@@ -317,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.