codex-dev-mcp-suite 1.5.0 → 1.6.0

package/bin/prune.mjs

@@ -35,7 +35,7 @@ function resolveRoot() {
       return parent;
     }
   }
-  return path.join(os.homedir(), ".codex", "memories");
+  return path.join(os.homedir(), ".ai-shared-memory");
 }
 
 function parseArgs(argv) {

package/bin/stats.mjs

@@ -36,7 +36,7 @@ function resolveRoot() {
       return parent;
     }
   }
-  return path.join(os.homedir(), ".codex", "memories");
+  return path.join(os.homedir(), ".ai-shared-memory");
 }
 
 function parseArgs(argv) {

package/checkpoint/server.js

@@ -24,7 +24,7 @@ import crypto from "crypto";
 
 const ROOT =
   process.env.CHECKPOINT_DIR ||
-  path.join(os.homedir(), ".codex", "memories", "checkpoints");
+  path.join(os.homedir(), ".ai-shared-memory", "checkpoints");
 
 const DEFAULT_IGNORE = new Set([
   "node_modules", ".git", ".next", "dist", "build", "target", ".venv",

package/devjournal/server.js

@@ -36,7 +36,7 @@ import { deterministicEnabled } from "./env.js";
 
 const ROOT =
   process.env.JOURNAL_DIR ||
-  path.join(os.homedir(), ".codex", "memories", "journal");
+  path.join(os.homedir(), ".ai-shared-memory", "journal");
 
 const MAX_TEXT = 20_000;
 
@@ -170,6 +170,16 @@ class DevJournalServer {
             properties: { dir: { type: "string", description: "Project directory (defaults to CWD)" } },
           },
         },
+        {
+          name: "initialize_agent_session",
+          description: "Initialize the current agent session. Run this ONCE when the agent starts in a new project to perform a handshake and get contextual handoff.",
+          inputSchema: {
+            type: "object",
+            properties: {
+              dir: { type: "string", description: "Project directory (defaults to CWD)" },
+            },
+          },
+        },
       ],
     }));
 
@@ -183,6 +193,7 @@ class DevJournalServer {
           case "journal_timeline": return await this.timeline(args || {});
           case "journal_search": return await this.search(args || {});
           case "journal_clear_handoff": return await this.clearHandoff(args || {});
+          case "initialize_agent_session": return await this.initializeAgent(args || {});
           default: throw new Error(`Unknown tool: ${name}`);
         }
       } catch (e) {
@@ -301,6 +312,30 @@ class DevJournalServer {
     return { content: [{ type: "text", text: `Cleared handoff for ${p.slug}` }] };
   }
 
+  async initializeAgent({ dir }) {
+    const agentName = process.env.MCP_AGENT_NAME || 'Unknown-Agent';
+    const resumeData = await this.resume({ dir, recent: 5 });
+    
+    let rules = "";
+    try {
+      const p = this.paths(dir);
+      const rulePath = path.join(p.root, ".ai", "AGENTS.md");
+      const r = await fs.readFile(rulePath, "utf8");
+      rules = `\n\n## Project Rules (.ai/AGENTS.md)\n${r}`;
+    } catch { 
+      try {
+        const rootRule = path.join(this.paths(dir).root, "AGENTS.md");
+        const rr = await fs.readFile(rootRule, "utf8");
+        rules = `\n\n## Project Rules (AGENTS.md)\n${rr}`;
+      } catch {}
+    }
+
+    const greeting = `# Universal MCP Handshake\nAgent: ${agentName}\n\n`;
+    const content = greeting + resumeData.content[0].text + rules;
+    
+    return { content: [{ type: "text", text: content }] };
+  }
+
   async run() {
     const t = new StdioServerTransport();
     await this.server.connect(t);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-dev-mcp-suite",
-  "version": "1.5.0",
+  "version": "1.6.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",

package/project-memory/server.js

@@ -20,6 +20,7 @@ import {
   CallToolRequestSchema,
   ListToolsRequestSchema,
   ListResourcesRequestSchema,
+  ListResourceTemplatesRequestSchema,
   ReadResourceRequestSchema,
 } from "@modelcontextprotocol/sdk/types.js";
 import fs from "fs/promises";
@@ -37,7 +38,7 @@ import { computeStats, formatText, formatJson } from "../lib/stats.js";
 
 const VAULT_ROOT =
   process.env.MEMORY_VAULT_DIR ||
-  path.join(os.homedir(), ".codex", "memories", "vault");
+  path.join(os.homedir(), ".ai-shared-memory", "vault");
 
 const MAX_CONTENT = 200_000;
 const MAX_TITLE = 200;
@@ -332,6 +333,8 @@ class ProjectMemoryServer {
       return { resources };
     });
 
+    this.server.setRequestHandler(ListResourceTemplatesRequestSchema, async () => ({ resourceTemplates: [] }));
+
     this.server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
       const uri = request.params.uri || "";
       const m = uri.match(/^memory:\/\/([^/]+)\/(.+)$/);
@@ -644,7 +647,7 @@ class ProjectMemoryServer {
             ? path.dirname(process.env.JOURNAL_DIR)
             : process.env.CHECKPOINT_DIR
               ? path.dirname(process.env.CHECKPOINT_DIR)
-              : path.join(os.homedir(), ".codex", "memories"));
+              : path.join(os.homedir(), ".ai-shared-memory"));
     const stats = computeStats({ root, topLimit: top });
     const text = json ? formatJson(stats) : formatText(stats);
     return { content: [{ type: "text", text }] };