@maind-dev/mcp-bridge 0.91.0 → 0.93.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
@@ -2,7 +2,7 @@
2
2
 
3
3
  A tiny local MCP wrapper that pins your [maind](https://maind.dev) API key to
4
4
  a single device. The bridge speaks MCP over stdio to your IDE (Claude Code,
5
- Cursor, Windsurf, GitHub Copilot in VS Code, Cline, Continue, …) and forwards every request to `https://mcp.maind.dev/mcp`
5
+ Cursor, Devin Desktop (formerly Windsurf), GitHub Copilot in VS Code, Cline, Continue, …) and forwards every request to `https://mcp.maind.dev/mcp`
6
6
  with an `X-Maind-Device-Id` header, so the server can refuse calls from any
7
7
  other machine that tries to reuse the same key.
8
8
 
@@ -107,7 +107,8 @@ again unless you re-pair).
107
107
  | Claude Code (user) | `~/.claude.json` | always |
108
108
  | Claude Desktop | `claude_desktop_config.json` (per-OS path) | always |
109
109
  | Cursor | `~/.cursor/mcp.json` | Cursor is installed, or `--client cursor` |
110
- | Windsurf | `~/.codeium/windsurf/mcp_config.json` | Windsurf is installed, or `--client windsurf` |
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
+ | 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 |
111
112
  | GitHub Copilot (VS Code) | user-profile `mcp.json` (per-OS path, `servers` shape) | VS Code is installed, or `--client copilot` |
112
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` |
113
114
  | Continue | `~/.continue/mcpServers/maind.json` — a file of its own; `config.yaml` is never touched | Continue is installed, or `--client continue` |
@@ -115,6 +116,8 @@ again unless you re-pair).
115
116
 
116
117
  A client that is not installed gets no file of ours (since **0.85.0** for Cursor
117
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.
118
121
  "Installed" means a trace only the client leaves, never a file or directory the
119
122
  bridge writes itself (since **0.87.0** — bridges up to 0.84.0 wrote
120
123
  `~/.cursor/mcp.json` and `~/.codeium/windsurf/mcp_config.json` on every
@@ -123,9 +126,9 @@ machine):
123
126
  | Client | Counts as installed when |
124
127
  |---|---|
125
128
  | 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` |
126
- | Windsurf | its app data (`…/Windsurf`) holds more than `User/`, or `~/.codeium/windsurf` holds more than `mcp_config.json` |
129
+ | 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` |
127
130
  | VS Code | its app data (`…/Code`) holds more than `User/` |
128
- | Cline | `~/.cline/data` holds more than `settings/`, or an editor (Code, Code - Insiders, Cursor, VSCodium, Windsurf, AgentComposer) has Cline's `User/globalStorage/saoudrizwan.claude-dev` |
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` |
129
132
  | Continue | `~/.continue` holds more than `mcpServers/` |
130
133
 
131
134
  The report shows a skipped client as `skipped` with the reason (e.g. `Cursor
@@ -240,6 +243,42 @@ path and a 2,000-character preview.
240
243
  (`declined_hooks` in the bridge config) and not nagged about;
241
244
  `install --hooks-only` asks again.
242
245
 
246
+ ## Cursor: conventions at session start
247
+
248
+ Cursor documents hooks in `~/.cursor/hooks.json`, and its `sessionStart` hook
249
+ may return `additional_context` — "Additional context to add to the
250
+ conversation's initial system context" (cursor.com/docs/hooks). Since
251
+ **0.93.0**:
252
+
253
+ - **What.** `on-cursor-session-start` returns the same block the Claude Code
254
+ session-start delivery prints — project conventions first, then lessons,
255
+ skills and memory titles, under a 9,000-byte budget — as
256
+ `{"additional_context": …}`. Its stdout is always one JSON object (`{}` when
257
+ there is nothing to say), because Cursor parses it. The repository comes from
258
+ `CURSOR_PROJECT_DIR` or the payload's `workspace_roots` (user hooks run with
259
+ cwd `~/.cursor/`).
260
+ - **Where.** `install` appends one entry under `hooks.sessionStart` in
261
+ `~/.cursor/hooks.json` (creating the file with `version: 1` if needed): own
262
+ consent, append-only — foreign hooks, events and keys are left as they are,
263
+ and a file in another shape is reported, never rewritten —, idempotent,
264
+ `--dry-run` aware.
265
+ - **Only where Cursor is installed** — the same evidence the Cursor MCP target
266
+ uses (`cursorInstalled`, since 0.87.0): Cursor's app-data directory holding
267
+ more than `User`, or a `~/.cursor` holding anything besides the files the
268
+ bridge writes there (`mcp.json`, `hooks.json`). A `~/.cursor/mcp.json` alone
269
+ does not count — older bridges created it on machines without Cursor.
270
+ `--client cursor` overrides the probe.
271
+ - **Existing installs.** `install --hooks-only` offers the Cursor hook too,
272
+ where Cursor is installed — no full install needed. Cursor reloads
273
+ `~/.cursor/hooks.json` by itself.
274
+ - **Measured, not assumed.** Each delivery is noted with its
275
+ `transcript_path` in `~/.maind/cursor/deliveries.jsonl` (local only), and
276
+ `maind sessions scan-conventions --client cursor` checks the transcripts
277
+ against it. Cursor staff confirm a race in which `additional_context` can be
278
+ dropped, and `sessionStart` does not run again on resume — the `AGENTS.md`
279
+ block below is the reliable channel in Cursor. We claim nothing for Cursor
280
+ until the scan says `measured_*`.
281
+
243
282
  ## AGENTS.md readers: conventions via AGENTS.md
244
283
 
245
284
  Measured on 2026-09-30 over 76 Codex rollouts: the MCP `instructions` never
@@ -251,8 +290,11 @@ client that reads `AGENTS.md` per the vendor's own documentation (checked
251
290
  2026-10-04): **Cursor** ("supports AGENTS.md in the project root and
252
291
  subdirectories") and **VS Code Copilot** (`chat.useAgentsMdFile`, on by
253
292
  default). For both the channel is documented, not yet measured here — we claim
254
- nothing until it is. Windsurf sessions get the same refresh; whether Windsurf
255
- (now Devin Desktop) reads `AGENTS.md` is not established here.
293
+ nothing until it is. **Devin Desktop** (formerly Windsurf) sessions get the
294
+ same refresh, and per its docs its agent, Devin Local, reads `AGENTS.md` too —
295
+ at the project root, as an always-on rule (docs.devin.ai
296
+ `cli/extensibility/rules`, checked 2026-10-04); documented, not measured here
297
+ either.
256
298
 
257
299
  - **What.** A managed block between `<!-- maind:conventions v1 begin -->` and
258
300
  `<!-- maind:conventions v1 end -->`, placed inside the `## maind MCP
@@ -264,7 +306,7 @@ nothing until it is. Windsurf sessions get the same refresh; whether Windsurf
264
306
  boundary; what does not fit is named: `… (N more via get_conventions)`.
265
307
  - **When.** `install` fills the block as soon as the pairing yields
266
308
  conventions — if the run sets up at least one client the refresh serves
267
- (Codex, Cursor, Windsurf, Copilot; own report row
309
+ (Codex, Cursor, Devin Desktop, Copilot; own report row
268
310
  `preamble:AGENTS.md#conventions`, `skipped (no selected client uses
269
311
  the AGENTS.md block …)` otherwise; `skipped (no conventions yet)` without conventions;
270
312
  `--dry-run` reads the cache only and reports `would insert`). Every session
@@ -315,6 +357,7 @@ nothing until it is. Windsurf sessions get the same refresh; whether Windsurf
315
357
  | `~/.maind/guard/agents-md-refresh.json` | When the `AGENTS.md` conventions block was last checked, per project (path hashed; mode 0600) |
316
358
  | `~/.maind/guard/briefing-cache.json` | The last session briefing + conventions, for the session-start hook and the `AGENTS.md` block (12 h; mode 0600) |
317
359
  | `~/.maind/context/<session>/` | Once-per-session markers of the context hooks: one empty file per delivered item, named by a hash; swept after 7 days |
360
+ | `~/.maind/cursor/deliveries.jsonl` | What the Cursor sessionStart hook delivered: conversation id, transcript path, size (local, pruned; mode 0600) |
318
361
 
319
362
  To rebind the bridge to a different account: delete the directory above (or run
320
363
  `--reauth`) and restart the bridge.