@maind-dev/mcp-bridge 0.94.0 → 0.95.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -105,39 +105,52 @@ again unless you re-pair).
105
105
  |---|---|---|
106
106
  | Claude Code (project) | `<project>/.mcp.json` | always |
107
107
  | Claude Code (user) | `~/.claude.json` | always |
108
- | Claude Desktop | `claude_desktop_config.json` (per-OS path) | always |
108
+ | Claude Desktop | `claude_desktop_config.json` (per-OS path) | Claude Desktop is installed, or `--client claude-desktop` |
109
109
  | Cursor | `~/.cursor/mcp.json` | Cursor is installed, or `--client cursor` |
110
110
  | Devin Desktop (formerly Windsurf) | Devin's own `mcp_config.json` — `~/.config/devin/` on macOS and Linux (`$XDG_CONFIG_HOME/devin/` when set), `%APPDATA%\devin\` on Windows; the Devin CLI reads it too | Devin Desktop is installed, or `--client windsurf` (alias `--client devin`) |
111
111
  | Devin Desktop, legacy file | `~/.codeium/windsurf/mcp_config.json` — Devin imports it; an existing `maind` entry is kept current, the file is never created and never gets an entry | Devin Desktop is installed and the entry is already there |
112
112
  | GitHub Copilot (VS Code) | user-profile `mcp.json` (per-OS path, `servers` shape) | VS Code is installed, or `--client copilot` |
113
113
  | Cline | `~/.cline/data/settings/cline_mcp_settings.json` — one file for Cline in every editor, its CLI and Cline Desktop | Cline is installed, or `--client cline` |
114
114
  | Continue | `~/.continue/mcpServers/maind.json` — a file of its own; `config.yaml` is never touched | Continue is installed, or `--client continue` |
115
- | Codex CLI | `~/.codex/config.toml` | always, unless `--skip-codex` |
116
-
117
- A client that is not installed gets no file of ours (since **0.85.0** for Cursor
118
- and Windsurf, **0.83.0** for VS Code, **0.87.0** for Cline and Continue).
119
- Windsurf became Devin Desktop on 2026-06-02; since **0.92.0** the bridge writes
120
- Devin's own file — the family id stays `windsurf` in every config it writes.
121
- "Installed" means a trace only the client leaves, never a file or directory the
122
- bridge writes itself (since **0.87.0** — bridges up to 0.84.0 wrote
123
- `~/.cursor/mcp.json` and `~/.codeium/windsurf/mcp_config.json` on every
124
- machine):
115
+ | Codex CLI | `config.toml` in Codex's home — `~/.codex/`, or `$CODEX_HOME` when set (absolute paths only); the Codex IDE extension and the ChatGPT desktop app share it | Codex is installed, or `--client codex`; `--skip-codex` leaves an installed Codex out |
116
+
117
+ Only Claude Code's two files are written on every machine. A client that is not
118
+ installed gets no file of ours (since **0.85.0** for Cursor and Windsurf,
119
+ **0.83.0** for VS Code, **0.87.0** for Cline and Continue, **0.95.0** for Claude
120
+ Desktop and Codex). Windsurf became Devin Desktop on 2026-06-02; since
121
+ **0.92.0** the bridge writes Devin's own file — the family id stays `windsurf`
122
+ in every config it writes. "Installed" means a trace only the client leaves,
123
+ never a file or directory the bridge writes itself (since **0.87.0** — bridges
124
+ up to 0.84.0 wrote `~/.cursor/mcp.json` and
125
+ `~/.codeium/windsurf/mcp_config.json` on every machine, bridges up to 0.94.0
126
+ Claude Desktop's and Codex's files):
125
127
 
126
128
  | Client | Counts as installed when |
127
129
  |---|---|
130
+ | Claude Desktop | its app data (`~/Library/Application Support/Claude`, `%APPDATA%\Claude`, `~/.config/Claude`) holds more than `claude_desktop_config.json`; on macOS also `/Applications/Claude.app` or `~/Applications/Claude.app`; on Windows also `%LOCALAPPDATA%\AnthropicClaude` (the .exe install) or `%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc` (the MSIX install) |
128
131
  | Cursor | its app data (`~/Library/Application Support/Cursor`, `%APPDATA%\Cursor`, `~/.config/Cursor`) holds more than `User/`, or `~/.cursor` holds more than `mcp.json` / `hooks.json` |
129
132
  | Devin Desktop (formerly Windsurf) | its app data (`~/Library/Application Support/Devin`, `%APPDATA%\Devin`, `~/.config/Devin`) holds more than `User/` (and, on Windows, where it is the same directory as `%APPDATA%\devin`, more than our `mcp_config.json`), `~/.devin` exists, Devin's config dir holds more than `mcp_config.json`, Windsurf's app data (`…/Windsurf`) holds more than `User/`, or `~/.codeium/windsurf` holds more than `mcp_config.json` |
130
133
  | VS Code | its app data (`…/Code`) holds more than `User/` |
131
- | Cline | `~/.cline/data` holds more than `settings/`, or an editor (Code, Code - Insiders, Cursor, VSCodium, Windsurf, Devin, AgentComposer) has Cline's `User/globalStorage/saoudrizwan.claude-dev` |
132
- | Continue | `~/.continue` holds more than `mcpServers/` |
134
+ | Cline | `~/.cline/data` holds more than `settings/`, an editor (Code, Code - Insiders, Cursor, VSCodium, Windsurf, Devin, AgentComposer) has Cline's `User/globalStorage/saoudrizwan.claude-dev`, or Cline's extension folder (`saoudrizwan.claude-dev-<version>`) is in an editor's extensions dir — see below |
135
+ | Continue | `~/.continue` holds more than `mcpServers/`, or Continue's extension folder (`continue.continue-<version>`) is in an editor's extensions dir — see below |
136
+ | Codex | its home (`$CODEX_HOME`, else `~/.codex`) holds more than `config.toml` — Codex keeps `auth.json`, `sessions/`, `history.jsonl`, … there; with `CODEX_HOME` set, a `~/.codex` beyond `config.toml` counts too |
137
+
138
+ An agent that ships as an editor extension counts as installed once its folder
139
+ is there, before it ever ran (since **0.95.0**): the editors' per-user
140
+ extensions dirs (`~/.vscode`, `~/.vscode-insiders`, `~/.cursor`, `~/.vscode-oss`,
141
+ `~/.windsurf`, `~/.devin`, `~/.agentcomposer`, each `/extensions`), the builtins
142
+ of the app bundle the bridge itself runs from (`<App>.app/Contents/Resources/app/extensions`),
143
+ and on macOS AgentComposer's builtins at `/Applications` or `~/Applications` —
144
+ AgentComposer ships Cline and Continue built in, and on its first start
145
+ neither has data of its own yet.
133
146
 
134
147
  The report shows a skipped client as `skipped` with the reason (e.g. `Cursor
135
148
  not found (no Cursor app data, nothing of Cursor's in ~/.cursor)`); when a
136
149
  leftover file sits there, the row says so. The exit code stays 0.
137
150
  Naming the family with `--client` is the explicit request that overrides the
138
- probe. `CLINE_DIR`, `CLINE_DATA_DIR`, `CLINE_MCP_SETTINGS_PATH` and
139
- `CONTINUE_GLOBAL_DIR` move the Cline and Continue files the way the clients
140
- resolve them (absolute paths only).
151
+ probe. `CLINE_DIR`, `CLINE_DATA_DIR`, `CLINE_MCP_SETTINGS_PATH`,
152
+ `CONTINUE_GLOBAL_DIR` and `CODEX_HOME` move the Cline, Continue and Codex files
153
+ the way the clients resolve them (absolute paths only).
141
154
 
142
155
  ### Leftover configs: `doctor --remove-phantoms`
143
156
 
@@ -146,7 +159,9 @@ as a **phantom** — nothing reads it. `doctor --remove-phantoms` lists what it
146
159
  would do and changes nothing; `doctor --remove-phantoms --yes` applies the same
147
160
  list. A file that holds only maind's entry is deleted; a file with anything
148
161
  else in it (other servers, other keys, comments) loses only maind's entry,
149
- every other byte stays.
162
+ every other byte stays. Codex's `config.toml` follows the same rules: only
163
+ `[mcp_servers.maind]` and its sub-tables are cut out, and an entry that is not
164
+ in tables of its own is listed for removal by hand, never touched.
150
165
 
151
166
  ### Claude Code hook subcommands
152
167