@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 +50 -7
- package/build/index.js +248 -234
- package/build/meta.json +1 -1
- package/package.json +2 -2
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 |
|
|
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
|
|
255
|
-
|
|
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,
|
|
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.
|