mrmainspring 0.1.9 → 0.2.1

package/dist/cli.d.ts

@@ -3,7 +3,7 @@ type InitResult = {
     dataDir: string;
     logsDir: string;
 };
-export declare function runCliCommand(args: string[]): boolean;
+export declare function runCliCommand(args: string[]): Promise<boolean>;
 export declare function initializeLocalSetup(env?: NodeJS.ProcessEnv): InitResult;
 export declare function formatMcpConfig(): string;
 export {};

package/dist/cli.js

@@ -2,8 +2,9 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { spawnSync } from "node:child_process";
 import { fileURLToPath } from "node:url";
+import * as clack from "@clack/prompts";
 import { loadConfig } from "./config.js";
-import { setupAllClients, formatClientSetupReport } from "./client-setup.js";
+import { detectClients, configureClients, setupAllClients, formatClientSetupReport } from "./client-setup.js";
 import { ensureGrimoireMasterKey, loadLocalEnvFile, resolveEnvPath } from "./env-file.js";
 import { getDefaultMainspringPaths } from "./paths.js";
 const _pkgRoot = dirname(dirname(fileURLToPath(import.meta.url)));
@@ -34,7 +35,7 @@ Advanced users can still set SIGIL_ENV_FILE, SIGIL_DATA_DIR, Supabase, Casper,
 and x402 env vars. No env vars are required for local memory, Grimoire, audit,
 or payment preflight tools.
 `;
-export function runCliCommand(args) {
+export async function runCliCommand(args) {
     const [command, target] = args;
     if (!command || command === "stdio" || command === "server" || command === "mcp") {
         return false;
@@ -57,23 +58,37 @@ export function runCliCommand(args) {
         return true;
     }
     if (command === "setup") {
-        const result = initializeLocalSetup();
-        process.stdout.write(formatInitResult(result));
-        const clientResults = setupAllClients();
-        const report = formatClientSetupReport(clientResults);
-        if (report) {
-            process.stdout.write(report);
+        if (process.stdin.isTTY) {
+            await runInteractiveSetup();
         }
         else {
-            process.stdout.write("\nNo MCP clients detected automatically.\n" +
-                "Add this to your MCP client config (Claude Desktop, Cursor, Windsurf, Zed, VS Code, Continue, or any MCP host):\n\n");
-            process.stdout.write(`${formatMcpConfig()}\n`);
-            process.stdout.write("\nConfig file locations:\n" +
-                "  Claude Desktop  ~/Library/Application Support/Claude/claude_desktop_config.json\n" +
-                "  Cursor          ~/.cursor/mcp.json\n" +
-                "  Windsurf        ~/.codeium/windsurf/mcp_config.json\n" +
-                "  Zed             ~/.config/zed/settings.json  (context_servers format)\n" +
-                "  VS Code         ~/.vscode/mcp.json\n\n");
+            const result = initializeLocalSetup();
+            process.stdout.write(formatInitResult(result));
+            const clientResults = setupAllClients();
+            const report = formatClientSetupReport(clientResults);
+            if (report) {
+                process.stdout.write(report);
+            }
+            else {
+                process.stdout.write("\nNo MCP clients detected automatically.\n" +
+                    "Add this to your MCP client config:\n\n");
+                process.stdout.write(`${formatMcpConfig()}\n`);
+                process.stdout.write("\nConfig file locations:\n" +
+                    "  Claude Desktop   ~/Library/Application Support/Claude/claude_desktop_config.json\n" +
+                    "  Claude Code      ~/.claude/settings.json\n" +
+                    "  Cursor           ~/.cursor/mcp.json\n" +
+                    "  Windsurf         ~/.codeium/windsurf/mcp_config.json\n" +
+                    "  Zed              ~/.config/zed/settings.json  (context_servers format)\n" +
+                    "  VS Code          ~/.vscode/mcp.json\n" +
+                    "  Cline            ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json\n" +
+                    "  Roo Code         ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json\n" +
+                    "  Kilo Code        ~/Library/Application Support/Code/User/globalStorage/kilocode.kilo-code/settings/cline_mcp_settings.json\n" +
+                    "  OpenCode         ~/.config/opencode/config.json\n" +
+                    "  Amazon Q         ~/.aws/amazonq/mcp.json\n" +
+                    "  Gemini CLI       ~/.gemini/settings.json\n" +
+                    "  Codex CLI        ~/.codex/config.json\n" +
+                    "  Continue.dev     ~/.continue/config.json  (array format)\n\n");
+            }
         }
         return true;
     }
@@ -92,6 +107,114 @@ export function runCliCommand(args) {
     process.exitCode = 1;
     return true;
 }
+const CLOCK_ART = [
+    "                ╷                ",
+    "           ╭────┴────╮           ",
+    "          ╭╯   12    ╰╮          ",
+    "          │ 11  │  1  │          ",
+    "          │     │     │          ",
+    "       9 ─┤   ──◎     ├─ 3       ",
+    "          │           │          ",
+    "          │ 8      4  │          ",
+    "          ╰╮  7  5   ╭╯          ",
+    "           ╰╮   6   ╭╯           ",
+    "            ╰────────╯            ",
+    "                                  ",
+    "          Mr Mainspring           ",
+    "    Memory  ·  Anchor  ·  Pay     ",
+].join("\n");
+async function runInteractiveSetup() {
+    process.stdout.write(`\n${CLOCK_ART}\n\n`);
+    clack.intro("setup");
+    const result = initializeLocalSetup();
+    clack.log.success(`Local files ready\n   Config: ${result.envFile}\n   Data:   ${result.dataDir}`);
+    const clients = detectClients();
+    const installed = clients.filter(c => c.installed);
+    const choices = await clack.multiselect({
+        message: "Which MCP clients should we configure?",
+        options: clients.map(c => ({
+            value: c,
+            label: c.name,
+            hint: c.installed ? c.configPath : "not detected — config will be created"
+        })),
+        initialValues: installed,
+        required: false
+    });
+    if (clack.isCancel(choices)) {
+        clack.cancel("Setup cancelled.");
+        process.exitCode = 1;
+        return;
+    }
+    const selected = choices;
+    if (selected.length === 0) {
+        clack.log.warn("No clients selected.");
+        const customPath = await clack.text({
+            message: "Enter a config file path to configure manually (or press Enter to skip):",
+            placeholder: "~/.config/myapp/mcp.json",
+            validate: () => undefined
+        });
+        if (!clack.isCancel(customPath) && customPath && customPath.trim()) {
+            const expandedPath = customPath.replace(/^~/, process.env.HOME ?? "");
+            const configResults = configureClients([
+                { name: "Custom", configPath: expandedPath, installed: true, format: "standard" }
+            ]);
+            const r = configResults[0];
+            if (r?.status === "written")
+                clack.log.success(`Configured: ${expandedPath}`);
+            else if (r?.status === "already-set")
+                clack.log.info(`Already configured: ${expandedPath}`);
+            else if (r?.error)
+                clack.log.error(`Failed: ${r.error}`);
+        }
+        else {
+            clack.log.info("Add this JSON to your MCP client config:\n\n" + formatMcpConfig());
+        }
+        clack.outro("Restart your MCP client after updating the config.");
+        return;
+    }
+    const configResults = configureClients(selected);
+    const written = configResults.filter(r => r.status === "written").map(r => r.name);
+    const alreadySet = configResults.filter(r => r.status === "already-set").map(r => r.name);
+    const errors = configResults.filter(r => r.status === "error");
+    if (written.length > 0)
+        clack.log.success(`Configured: ${written.join(", ")}`);
+    if (alreadySet.length > 0)
+        clack.log.info(`Already configured: ${alreadySet.join(", ")}`);
+    for (const e of errors)
+        clack.log.error(`${e.name}: ${e.error}`);
+    const wantCasper = await clack.confirm({
+        message: "Enable Casper on-chain anchoring?",
+        initialValue: false
+    });
+    if (clack.isCancel(wantCasper)) {
+        clack.cancel("Setup cancelled.");
+        return;
+    }
+    if (wantCasper) {
+        clack.log.info("Add to your .env file:\n\n" +
+            "  CASPER_ENABLE_REAL_SUBMISSION=true\n" +
+            "  CASPER_RPC_URL=https://node.testnet.casper.network/rpc\n" +
+            "  CASPER_ACCOUNT_KEY_PATH=./keys/your-key.pem\n\n" +
+            "Then restart your MCP client.");
+    }
+    const wantX402 = await clack.confirm({
+        message: "Enable x402 micropayments?",
+        initialValue: false
+    });
+    if (clack.isCancel(wantX402)) {
+        clack.cancel("Setup cancelled.");
+        return;
+    }
+    if (wantX402) {
+        clack.log.info("Add to your .env file:\n\n" +
+            "  X402_ENABLE_REAL_SETTLEMENT=true\n" +
+            "  X402_SETTLEMENT_MODE=casper-cli\n" +
+            "  X402_BUYER_ACCOUNT_HASH=account-hash-<64 hex chars>\n" +
+            "  CASPER_ENABLE_REAL_SUBMISSION=true\n\n" +
+            "Get your account hash: casper-client account-address --public-key <your-pubkey-hex>");
+    }
+    clack.outro("Restart your MCP clients to load the server.");
+}
 export function initializeLocalSetup(env = process.env) {
     const paths = getDefaultMainspringPaths(env);
     const envFile = env.SIGIL_ENV_FILE?.trim() ? resolveEnvPath(env) : paths.envFile;

package/dist/client-setup.d.ts

@@ -4,5 +4,13 @@ export type ClientSetupResult = {
     status: "written" | "already-set" | "not-installed" | "error";
     error?: string;
 };
+export type ClientDetection = {
+    name: string;
+    configPath: string;
+    installed: boolean;
+    format: "standard" | "zed" | "continue";
+};
+export declare function detectClients(env?: NodeJS.ProcessEnv): ClientDetection[];
+export declare function configureClients(selected: ClientDetection[], env?: NodeJS.ProcessEnv): ClientSetupResult[];
 export declare function setupAllClients(env?: NodeJS.ProcessEnv): ClientSetupResult[];
 export declare function formatClientSetupReport(results: ClientSetupResult[]): string;

package/dist/client-setup.js

@@ -17,14 +17,81 @@ const CLIENTS = [
     { name: "Cursor", path: "%USERPROFILE%/.cursor/mcp.json", platforms: ["win32"], format: "standard" },
     // Windsurf
     { name: "Windsurf", path: "~/.codeium/windsurf/mcp_config.json", platforms: ["darwin", "linux", "win32"], format: "standard" },
-    // Windsurf (also on Windows via AppData)
     { name: "Windsurf", path: "%APPDATA%/Windsurf/User/globalStorage/codeium.windsurf/mcp_config.json", platforms: ["win32"], format: "standard" },
     // Zed
     { name: "Zed", path: "~/.config/zed/settings.json", platforms: ["darwin", "linux"], format: "zed" },
     // Continue.dev
     { name: "Continue", path: "~/.continue/config.json", platforms: ["darwin", "linux", "win32"], format: "continue" },
-    // VS Code (workspace-agnostic user MCP config — requires MCP extension)
+    // VS Code (user-level MCP config — requires GitHub Copilot or MCP extension)
     { name: "VS Code", path: "~/.vscode/mcp.json", platforms: ["darwin", "linux", "win32"], format: "standard" },
+    // Cline (VS Code extension by saoudrizwan)
+    {
+        name: "Cline",
+        path: "~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json",
+        detectDir: "~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev",
+        platforms: ["darwin"], format: "standard"
+    },
+    {
+        name: "Cline",
+        path: "~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json",
+        detectDir: "~/.config/Code/User/globalStorage/saoudrizwan.claude-dev",
+        platforms: ["linux"], format: "standard"
+    },
+    {
+        name: "Cline",
+        path: "%APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json",
+        detectDir: "%APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev",
+        platforms: ["win32"], format: "standard"
+    },
+    // Roo Code (VS Code extension, fork of Cline)
+    {
+        name: "Roo Code",
+        path: "~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json",
+        detectDir: "~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline",
+        platforms: ["darwin"], format: "standard"
+    },
+    {
+        name: "Roo Code",
+        path: "~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json",
+        detectDir: "~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline",
+        platforms: ["linux"], format: "standard"
+    },
+    {
+        name: "Roo Code",
+        path: "%APPDATA%/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json",
+        detectDir: "%APPDATA%/Code/User/globalStorage/rooveterinaryinc.roo-cline",
+        platforms: ["win32"], format: "standard"
+    },
+    // Kilo Code (VS Code extension)
+    {
+        name: "Kilo Code",
+        path: "~/Library/Application Support/Code/User/globalStorage/kilocode.kilo-code/settings/cline_mcp_settings.json",
+        detectDir: "~/Library/Application Support/Code/User/globalStorage/kilocode.kilo-code",
+        platforms: ["darwin"], format: "standard"
+    },
+    {
+        name: "Kilo Code",
+        path: "~/.config/Code/User/globalStorage/kilocode.kilo-code/settings/cline_mcp_settings.json",
+        detectDir: "~/.config/Code/User/globalStorage/kilocode.kilo-code",
+        platforms: ["linux"], format: "standard"
+    },
+    {
+        name: "Kilo Code",
+        path: "%APPDATA%/Code/User/globalStorage/kilocode.kilo-code/settings/cline_mcp_settings.json",
+        detectDir: "%APPDATA%/Code/User/globalStorage/kilocode.kilo-code",
+        platforms: ["win32"], format: "standard"
+    },
+    // OpenCode (terminal AI coding assistant)
+    { name: "OpenCode", path: "~/.config/opencode/config.json", platforms: ["darwin", "linux"], format: "standard" },
+    { name: "OpenCode", path: "%APPDATA%/opencode/config.json", platforms: ["win32"], format: "standard" },
+    // Amazon Q Developer
+    { name: "Amazon Q", path: "~/.aws/amazonq/mcp.json", platforms: ["darwin", "linux"], format: "standard" },
+    { name: "Amazon Q", path: "%USERPROFILE%/.aws/amazonq/mcp.json", platforms: ["win32"], format: "standard" },
+    // Gemini CLI (Google)
+    { name: "Gemini CLI", path: "~/.gemini/settings.json", platforms: ["darwin", "linux"], format: "standard" },
+    { name: "Gemini CLI", path: "%USERPROFILE%/.gemini/settings.json", platforms: ["win32"], format: "standard" },
+    // Codex CLI (OpenAI)
+    { name: "Codex CLI", path: "~/.codex/config.json", platforms: ["darwin", "linux", "win32"], format: "standard" },
 ];
 function expandPath(p, env) {
     const home = env.HOME ?? env.USERPROFILE ?? homedir();
@@ -33,8 +100,9 @@ function expandPath(p, env) {
         .replace(/%APPDATA%/gi, env.APPDATA ?? "")
         .replace(/%USERPROFILE%/gi, env.USERPROFILE ?? home);
 }
-function isInstalled(configPath) {
-    return existsSync(dirname(configPath)) || existsSync(configPath);
+function isInstalled(configPath, detectDir) {
+    const dir = detectDir ?? dirname(configPath);
+    return existsSync(dir) || existsSync(configPath);
 }
 function readJson(path) {
     if (!existsSync(path))
@@ -82,6 +150,42 @@ function mergeConfig(json, format) {
         }
     };
 }
+export function detectClients(env = process.env) {
+    const plat = process.platform;
+    const seen = new Set();
+    const results = [];
+    for (const client of CLIENTS) {
+        if (!client.platforms.includes(plat))
+            continue;
+        const configPath = expandPath(client.path, env);
+        const key = `${client.name}:${configPath}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        const detectDir = client.detectDir ? expandPath(client.detectDir, env) : undefined;
+        results.push({ name: client.name, configPath, installed: isInstalled(configPath, detectDir), format: client.format });
+    }
+    return results;
+}
+export function configureClients(selected, env = process.env) {
+    const results = [];
+    for (const client of selected) {
+        try {
+            const json = readJson(client.configPath);
+            if (alreadySet(json, client.format)) {
+                results.push({ name: client.name, configPath: client.configPath, status: "already-set" });
+                continue;
+            }
+            mkdirSync(dirname(client.configPath), { recursive: true });
+            writeFileSync(client.configPath, JSON.stringify(mergeConfig(json, client.format), null, 2) + "\n", "utf8");
+            results.push({ name: client.name, configPath: client.configPath, status: "written" });
+        }
+        catch (e) {
+            results.push({ name: client.name, configPath: client.configPath, status: "error", error: String(e) });
+        }
+    }
+    return results;
+}
 export function setupAllClients(env = process.env) {
     const plat = process.platform;
     const results = [];
@@ -94,7 +198,8 @@ export function setupAllClients(env = process.env) {
         if (seen.has(key))
             continue;
         seen.add(key);
-        if (!isInstalled(configPath)) {
+        const detectDir = client.detectDir ? expandPath(client.detectDir, env) : undefined;
+        if (!isInstalled(configPath, detectDir)) {
             results.push({ name: client.name, configPath, status: "not-installed" });
             continue;
         }

package/dist/index.js

@@ -5,7 +5,7 @@ import { loadConfig } from "./config.js";
 import { ensureGrimoireMasterKey, loadLocalEnvFile } from "./env-file.js";
 import { createSigilServer } from "./server.js";
 async function main() {
-    if (runCliCommand(process.argv.slice(2))) {
+    if (await runCliCommand(process.argv.slice(2))) {
         return;
     }
     loadLocalEnvFile();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mrmainspring",
-  "version": "0.1.9",
+  "version": "0.2.1",
   "description": "Mr Mainspring MCP backend with memory, Grimoire policies, audit, Casper anchoring, and x402 settlement boundaries.",
   "license": "MIT",
   "type": "module",
@@ -47,6 +47,7 @@
     "x402:signer": "tsx scripts/x402-signer-sidecar.ts"
   },
   "dependencies": {
+    "@clack/prompts": "^1.5.1",
     "@modelcontextprotocol/sdk": "^1.13.0",
     "zod": "^3.25.76"
   },