codex-dev-mcp-suite 3.0.0 → 3.1.0

package/CHANGELOG.md

@@ -32,6 +32,16 @@
 
 # Changelog
 
+## 3.1.0 - 2026-07-22 — Interactive Installer Wizard & CI Suite 🛠️
+
+### Added
+- **`npx codex-dev-mcp-suite init` (Auto-Config Installer Wizard)**:
+  - Interactive CLI wizard (`lib/init-wizard.js` & `bin/init.mjs`) that automatically detects installed AI clients (Codex CLI, Claude Code, Cursor, Windsurf, Hermes Agent, Antigravity CLI) and injects the 4 MCP server configurations into their respective config files.
+- **GitHub Actions Smoke Expansion**:
+  - Extended `.github/workflows/ci.yml` package-smoke test to verify all 6 executable binaries and the `init` wizard.
+- **Real-World Multi-Agent Vibe Coding Guide (`examples/multi-agent-vibe-coding.md`)**:
+  - Sample workflows demonstrating how to combine Antigravity, Hermes, Claude Code, and Codex CLI using swarm streams, checkpoints, and impact prediction.
+
 ## 3.0.0 - 2026-07-22 — The Autonomous Agent OS Edition (God-Tier) 🌌
 
 ### Added

package/README.md

@@ -37,7 +37,13 @@ Published on npm as `codex-dev-mcp-suite`.
 
 ### ⚡ 10-Second Quickstart
 
-Try it right now without cloning or installing:
+Automatically configure all installed AI tools (Codex CLI, Claude Code, Cursor, Windsurf, Hermes, Antigravity) with 1 command:
+
+```bash
+npx -y codex-dev-mcp-suite init
+```
+
+Or test a single server right now without installing:
 
 ```bash
 npx -y -p codex-dev-mcp-suite project-memory-mcp --help

package/bin/init.mjs

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+import { runInitWizard } from "../lib/init-wizard.js";
+
+async function main() {
+  console.log("🛠️ Dev MCP Suite — Auto-Config Installer Wizard");
+  console.log("==================================================");
+
+  const dryRun = process.argv.includes("--dry-run");
+  const { detectedCount, results } = await runInitWizard({ dryRun });
+
+  if (!detectedCount) {
+    console.log("ℹ️ No supported AI client directories detected (~/.codex, ~/.claude, ~/.cursor, etc.).");
+    console.log("See README.md for manual configuration instructions.");
+    return;
+  }
+
+  for (const r of results) {
+    console.log(`✅ [${r.status}] Configured ${r.name} -> ${r.path}`);
+  }
+
+  console.log("\n🚀 All detected AI tools have been successfully configured with codex-dev-mcp-suite!");
+  console.log("Restart your AI coding client to start using the 4 MCP servers.");
+}
+
+main().catch(console.error);

package/lib/init-wizard.js

@@ -0,0 +1,120 @@
+/**
+ * Auto-Config Installer Wizard for codex-dev-mcp-suite.
+ * Detects installed AI tools (Codex, Claude Code, Cursor, Windsurf, Hermes, AGY)
+ * and configures the 4 MCP servers automatically.
+ */
+
+import fs from "fs/promises";
+import path from "path";
+import os from "os";
+
+const HOME = os.homedir();
+
+export const CLIENT_CONFIGS = [
+  {
+    name: "Codex CLI",
+    type: "toml",
+    path: path.join(HOME, ".codex", "config.toml"),
+    sampleSnippet: `
+[mcp_servers.project-memory]
+command = "npx"
+args = ["-y", "-p", "codex-dev-mcp-suite", "project-memory-mcp"]
+
+[mcp_servers.devjournal]
+command = "npx"
+args = ["-y", "-p", "codex-dev-mcp-suite", "devjournal-mcp"]
+
+[mcp_servers.checkpoint]
+command = "npx"
+args = ["-y", "-p", "codex-dev-mcp-suite", "checkpoint-mcp"]
+
+[mcp_servers.context-pack]
+command = "npx"
+args = ["-y", "-p", "codex-dev-mcp-suite", "context-pack-mcp"]
+`
+  },
+  {
+    name: "Claude Code",
+    type: "json",
+    path: path.join(HOME, ".claude.json"),
+  },
+  {
+    name: "Cursor",
+    type: "json",
+    path: path.join(HOME, ".cursor", "mcp.json"),
+  },
+  {
+    name: "Windsurf",
+    type: "json",
+    path: path.join(HOME, ".codeium", "windsurf", "mcp_config.json"),
+  },
+  {
+    name: "Hermes Agent",
+    type: "json",
+    path: path.join(HOME, ".hermes", "config.json"),
+  },
+  {
+    name: "Antigravity CLI",
+    type: "json",
+    path: path.join(HOME, ".gemini", "antigravity-cli", "mcp_servers.json"),
+  }
+];
+
+export async function detectClients() {
+  const detected = [];
+  for (const client of CLIENT_CONFIGS) {
+    try {
+      await fs.access(path.dirname(client.path));
+      detected.push(client);
+    } catch {}
+  }
+  return detected;
+}
+
+export async function configureJsonClient(configPath) {
+  let json = {};
+  try {
+    const raw = await fs.readFile(configPath, "utf8");
+    json = JSON.parse(raw);
+  } catch {}
+
+  json.mcpServers = json.mcpServers || {};
+  const servers = ["project-memory", "devjournal", "checkpoint", "context-pack"];
+  for (const s of servers) {
+    json.mcpServers[s] = {
+      command: "npx",
+      args: ["-y", "-p", "codex-dev-mcp-suite", `${s}-mcp`]
+    };
+  }
+
+  await fs.mkdir(path.dirname(configPath), { recursive: true });
+  await fs.writeFile(configPath, JSON.stringify(json, null, 2) + "\n");
+  return configPath;
+}
+
+export async function runInitWizard({ dryRun = false } = {}) {
+  const clients = await detectClients();
+  const results = [];
+
+  for (const c of clients) {
+    if (c.type === "json") {
+      if (!dryRun) {
+        await configureJsonClient(c.path);
+      }
+      results.push({ name: c.name, path: c.path, status: dryRun ? "PREVIEW" : "CONFIGURED 🟢" });
+    } else if (c.type === "toml") {
+      let content = "";
+      try {
+        content = await fs.readFile(c.path, "utf8");
+      } catch {}
+
+      if (!content.includes("[mcp_servers.project-memory]") && !dryRun) {
+        await fs.mkdir(path.dirname(c.path), { recursive: true });
+        await fs.appendFile(c.path, "\n" + c.sampleSnippet.trim() + "\n");
+      }
+      results.push({ name: c.name, path: c.path, status: dryRun ? "PREVIEW" : "CONFIGURED 🟢" });
+    }
+  }
+
+  return { detectedCount: clients.length, results };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-dev-mcp-suite",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "Four local, file-based MCP servers for solo devs/vibecoders: persistent project memory, session handoff/resume, git-independent file checkpoints, and token-efficient project briefings. Works with any MCP client.",
   "type": "module",
   "license": "MIT",
@@ -36,7 +36,9 @@
     "stats": "bin/stats.mjs",
     "prune": "bin/prune.mjs",
     "provider-smoke": "bin/provider-smoke.mjs",
-    "mcp-ui": "bin/ui.mjs"
+    "mcp-ui": "bin/ui.mjs",
+    "init": "bin/init.mjs",
+    "codex-dev-mcp-suite": "bin/init.mjs"
   },
   "scripts": {
     "test": "node run-tests.mjs",