gitmem-mcp 1.4.0 → 1.4.1

package/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.4.1] - 2026-02-22
+
+### Added
+- **AGENTS.md generation**: Init wizard now creates an IDE-agnostic `AGENTS.md` file alongside the client-specific instructions file. Contains tool table, core workflow, sub-agent patterns (`prepare_context`, `absorb_observations`), and example JSON tool calls. Read by Codex, Copilot, Gemini, Cursor, and other AI coding assistants for automatic project discovery.
+
 ## [1.4.0] - 2026-02-22
 
 ### Changed

package/bin/init-wizard.js

@@ -879,6 +879,51 @@ async function stepGitignore() {
   return { done: true };
 }
 
+async function stepAgentsMd() {
+  const agentsPath = join(cwd, "AGENTS.md");
+  const templatePath = join(__dirname, "..", "AGENTS.md.template");
+
+  // Already exists — don't overwrite
+  if (existsSync(agentsPath)) {
+    const content = readFileSync(agentsPath, "utf-8");
+    if (content.includes("GitMem")) {
+      log(CHECK, `AGENTS.md already includes gitmem`);
+      return { done: false };
+    }
+    // Existing AGENTS.md without gitmem — ask before appending
+    if (interactive) {
+      if (!(await confirm("Add gitmem section to existing AGENTS.md?"))) {
+        log(SKIP, "AGENTS.md skipped");
+        return { done: false };
+      }
+    }
+  }
+
+  let template;
+  try {
+    template = readFileSync(templatePath, "utf-8");
+  } catch {
+    // Template not found — skip silently
+    return { done: false };
+  }
+
+  if (dryRun) {
+    log(CHECK, `Would ${existsSync(agentsPath) ? "update" : "create"} AGENTS.md`, "[dry-run]");
+    return { done: true };
+  }
+
+  if (existsSync(agentsPath)) {
+    const existing = readFileSync(agentsPath, "utf-8");
+    writeFileSync(agentsPath, existing.trimEnd() + "\n\n" + template + "\n");
+    log(CHECK, "Updated AGENTS.md", "Added gitmem section (your existing content is preserved)");
+  } else {
+    writeFileSync(agentsPath, template + "\n");
+    log(CHECK, "Created AGENTS.md", "IDE-agnostic agent discovery file");
+  }
+
+  return { done: true };
+}
+
 async function stepFeedbackOptIn() {
   const configPath = join(gitmemDir, "config.json");
   const config = readJson(configPath) || {};
@@ -980,6 +1025,9 @@ async function main() {
   const r6 = await stepGitignore();
   if (r6.done) configured++;
 
+  const r6b = await stepAgentsMd();
+  if (r6b.done) configured++;
+
   const r7 = await stepFeedbackOptIn();
   if (r7.done) configured++;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gitmem-mcp",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "mcpName": "io.github.gitmem-dev/gitmem",
   "description": "Persistent learning memory for AI coding agents. Memory that compounds.",
   "type": "module",