patchcord 0.6.15 → 0.6.16

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "patchcord",
   "description": "Cross-machine agent messaging. Messages from other agents land in the inbox and wake the agent to reply.",
-  "version": "0.6.15",
+  "version": "0.6.16",
   "author": {
     "name": "ppravdin"
   },

package/bin/patchcord.mjs

@@ -1966,6 +1966,30 @@ if (!cmd || cmd === "install" || cmd === "agent" || cmd?.startsWith("--")) {
       } else if (allowlistChanged) {
         globalChanges.push("Cursor MCP allowlist configured");
       }
+
+      // cursor-agent v2026.07+ also reads ~/.cursor/cli-config.json permissions.allow
+      // for MCP tool approval — permissions.json alone leaves patchcord at
+      // "not loaded (needs approval)" even with --yolo.
+      const cliConfigPath = join(HOME, ".cursor", "cli-config.json");
+      let cliAllowChanged = false;
+      const cliOk = updateJsonConfig(cliConfigPath, (obj) => {
+        obj.permissions = obj.permissions || {};
+        if (!obj.permissions.allow) obj.permissions.allow = [];
+        if (!Array.isArray(obj.permissions.allow)) {
+          console.log(`\n  ${yellow}⚠${r} Skipped Cursor CLI MCP allow — ${cliConfigPath} permissions.allow is not an array.`);
+          return;
+        }
+        const pat = "Mcp(patchcord:*)";
+        if (!obj.permissions.allow.includes(pat)) {
+          obj.permissions.allow.push(pat);
+          cliAllowChanged = true;
+        }
+      });
+      if (!cliOk) {
+        globalChanges.push("✗ Cursor CLI permissions error");
+      } else if (cliAllowChanged) {
+        globalChanges.push("Cursor CLI MCP allowlist configured");
+      }
     }
   }
 
@@ -2403,6 +2427,13 @@ if (!cmd || cmd === "install" || cmd === "agent" || cmd?.startsWith("--")) {
     }
     toolSlug = toolFlag;  // preserved as-is for the URL param
   }
+  // cursor-agent --yolo runs `npx patchcord` without --tool=cursor. Without
+  // this, browser connect defaults to Claude and writes .mcp.json instead of
+  // .cursor/mcp.json — MCP never loads in cursor-agent.
+  if (!choice && process.env.CURSOR_AGENT) {
+    choice = CLIENT_TYPE_MAP.cursor;
+    toolSlug = toolSlug || "cursor";
+  }
 
   // --token bypass for power users / CI / self-hosters
   const tokenFlag = flags.find(f => f.startsWith("--token="))?.split("=")[1]
@@ -2453,12 +2484,14 @@ if (!cmd || cmd === "install" || cmd === "agent" || cmd?.startsWith("--")) {
     let existingToken = "";
     let existingConfigFile = "";
     const mcpJsonPath = join(cwd, ".mcp.json");
+    const cursorMcpPath = join(cwd, ".cursor", "mcp.json");
     const codexTomlPath = join(cwd, ".codex", "config.toml");
     const grokTomlPath = join(cwd, ".grok", "config.toml");
     const kimiJsonPath = join(cwd, ".kimi", "mcp.json");
 
-    const slugForCheck = toolSlug ? toolSlug.replace(/-/g, "_") : "";
+    const slugForCheck = toolSlug ? toolSlug.replace(/-/g, "_") : (process.env.CURSOR_AGENT ? "cursor" : "");
     const checkMcpJson = !slugForCheck || slugForCheck === "claude_code";
+    const checkCursorJson = !slugForCheck || slugForCheck === "cursor";
     const checkCodexToml = !slugForCheck || slugForCheck === "codex";
     const checkGrokToml = !slugForCheck || ["grok", "grok_cli", "grok_build"].includes(slugForCheck);
     const checkKimiJson = !slugForCheck || slugForCheck === "kimi";
@@ -2473,6 +2506,16 @@ if (!cmd || cmd === "install" || cmd === "agent" || cmd?.startsWith("--")) {
         }
       } catch {}
     }
+    if (!existingToken && checkCursorJson && existsSync(cursorMcpPath)) {
+      try {
+        const existing = JSON.parse(readFileSync(cursorMcpPath, "utf-8"));
+        const pt = existing?.mcpServers?.patchcord;
+        if (pt?.headers?.Authorization) {
+          existingToken = pt.headers.Authorization.replace(/^Bearer\s+/i, "");
+          existingConfigFile = cursorMcpPath;
+        }
+      } catch {}
+    }
     if (!existingToken && checkCodexToml && existsSync(codexTomlPath)) {
       try {
         const content = readFileSync(codexTomlPath, "utf-8");
@@ -3452,6 +3495,9 @@ if (!cmd || cmd === "install" || cmd === "agent" || cmd?.startsWith("--")) {
     console.log(`\n  ${green}→${r} ${bold}Restart ${cyan}kimi${r}${bold} in this project (or run ${cyan}/reload${r}${bold}), then say: ${cyan}${bold}check inbox${r}`);
   } else if (isKimi) {
     console.log(`\n  ${green}→${r} ${bold}Restart your ${toolName} session with ${cyan}kimi-pc${r}${bold}, then say: ${cyan}${bold}check inbox${r}`);
+  } else if (isCursor && hasCursorAgent) {
+    console.log(`\n  ${green}→${r} ${bold}Exit and start a new ${cyan}cursor-agent${r}${bold} session${r} ${dim}(MCP loads at session start — not mid-session)${r}`);
+    console.log(`  ${dim}Then:${r} ${cyan}${bold}check inbox${r} ${dim}before${r} ${cyan}${bold}/patchcord-subscribe${r}`);
   } else {
     console.log(`\n  ${green}→${r} ${bold}Restart your ${toolName} session${r}, then say: ${cyan}${bold}check inbox${r}`);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "patchcord",
-  "version": "0.6.15",
+  "version": "0.6.16",
   "description": "Cross-machine agent messaging for Claude Code and Codex",
   "scripts": {
     "version": "node scripts/sync-plugin-version.mjs && git add .claude-plugin/plugin.json"

package/per-project-skills/cursor/subscribe/SKILL.md

@@ -15,12 +15,21 @@ Start the persistent listener in a background Shell.
    expose it as `mcp_patchcord_inbox`). Process every pending message according
    to the patchcord inbox skill before starting the listener.
 
+   **Just provisioned in this same session?** Cursor/`cursor-agent` loads MCP
+   servers at session start only — `inbox()` will not exist until the user
+   starts a **new** session after connect. Do not spin on missing MCP tools.
+   Skip inbox drain, start the listener (step 3), and say one line: *MCP inbox
+   needs a fresh cursor-agent session after connect; listener is running — restart
+   once, then say check inbox.*
+
 2. **Find the absolute project root.** Use the current session's git root or
    agent worktree. Do not rely on the ambient Shell cwd: the listener must read
    the `.cursor/mcp.json` for this project and therefore needs an explicit
    `cd`.
 
-3. **Spawn the background listener** with Cursor's Shell tool:
+3. **Spawn the background listener** with Cursor's Shell tool. **Always**
+   `block_until_ms: 0` — never run subscribe in the foreground (that yields
+   "Wait skipped" and no wake notifications):
 
    ```text
    Shell(