cortex-sync 0.2.0 → 0.3.0

package/README.md

@@ -59,20 +59,28 @@ Open any project on Machine B — Claude Code shows your full session history.
 | `cortex pull` | Download, decrypt, remap paths |
 | `cortex status` | Show what's out of sync (no download) |
 | `cortex convert <file> --to <target>` | Convert a Claude Code skill |
+| `cortex setup-mcp` | Register cortex as a Claude Code MCP server |
 
 ---
 
 ## Claude Code MCP integration
 
-Install cortex as a Claude Code MCP server to use `sync`, `pull`, `status`, `convert`, and `init` directly from the chat:
+Use `sync`, `pull`, `status`, `convert`, and `init` directly from the Claude Code chat — one command does everything:
 
 ```bash
 npm install -g cortex-sync
-cortex init                           # configure once from terminal
-export CORTEX_PASSPHRASE="..."        # add to ~/.zshrc
-claude mcp add cortex -- cortex mcp  # register in Claude Code
+cortex init       # configure storage and passphrase
+cortex setup-mcp  # registers cortex in Claude Code automatically
 ```
 
+That's it. Restart Claude Code and you're done.
+
+### What setup-mcp does
+
+`cortex setup-mcp` detects the binary path, prompts for your passphrase once, and runs `claude mcp add` with the correct arguments — no manual PATH configuration needed.
+
+### Available MCP tools
+
 | Tool | What it does |
 |---|---|
 | `sync` | Encrypt and upload `~/.claude/` |
@@ -81,7 +89,7 @@ claude mcp add cortex -- cortex mcp  # register in Claude Code
 | `convert` | Convert a skill to Antigravity or Cursor |
 | `init` | Configure storage (non-interactive) |
 
-**Environment variables used by the MCP server:**
+### Environment variables (advanced / manual setup)
 
 | Variable | Required for |
 |---|---|

package/dist/cli.js

@@ -1302,6 +1302,44 @@ ${lines.join("\n")}`
   });
 }
 
+// src/commands/setup-mcp.ts
+import { password as password4 } from "@inquirer/prompts";
+import { existsSync as existsSync7 } from "fs";
+import { spawnSync } from "child_process";
+import { dirname as dirname6, join as join11 } from "path";
+async function setupMcpCommand() {
+  const cortexBin = join11(dirname6(process.execPath), "cortex");
+  if (!existsSync7(cortexBin)) {
+    throw new Error(
+      `cortex binary not found at ${cortexBin}.
+Make sure cortex-sync is installed globally: npm install -g cortex-sync`
+    );
+  }
+  console.log(`Found cortex at: ${cortexBin}`);
+  const passphrase = await password4({
+    message: "Encryption passphrase (same one used in cortex init):",
+    mask: "*",
+    validate: (v) => v.length >= 12 || "Minimum 12 characters"
+  });
+  const result = spawnSync(
+    "claude",
+    ["mcp", "add", "cortex", "-e", `CORTEX_PASSPHRASE=${passphrase}`, "--", cortexBin, "mcp"],
+    { stdio: "inherit" }
+  );
+  if (result.error) {
+    throw new Error(
+      `Failed to run "claude" CLI: ${result.error.message}
+Make sure Claude Code CLI is installed and "claude" is in your PATH.`
+    );
+  }
+  if (result.status !== 0) {
+    throw new Error('"claude mcp add" failed. Check the output above for details.');
+  }
+  console.log("\n\u2713 cortex MCP server registered in Claude Code.");
+  console.log("Restart Claude Code (or open a new session) to activate it.");
+  console.log("\nTo verify: claude mcp list");
+}
+
 // src/cli.ts
 var require2 = createRequire(import.meta.url);
 var { version } = require2("../package.json");
@@ -1320,4 +1358,5 @@ program.command("convert <skill-file>").description("Convert a Claude Code skill
   return convertCommand(skillFile, { to: opts.to, outputDir: opts.outputDir });
 });
 program.command("mcp").description("Start the MCP server (for use with claude mcp add cortex -- cortex mcp)").action(mcpCommand);
+program.command("setup-mcp").description("Register cortex as a Claude Code MCP server automatically").action(setupMcpCommand);
 await program.parseAsync(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cortex-sync",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Sync Claude Code sessions between machines with automatic path remapping and skill conversion",
   "license": "AGPL-3.0",
   "type": "module",