fathom-mcp 0.2.3 → 0.3.1

package/CHANGELOG.md

@@ -1,12 +1,18 @@
 # Changelog
 
+## 0.3.1 (2026-02-26)
+
+- **Agent type registration** — init wizard sends primary agent type when registering workspace with server
+- **Terminal bypass_permissions** — respects per-workspace session settings instead of always forcing bypass
+
 ## 0.2.0 (2026-02-26)
 
 Multi-agent support.
 
 - **Multi-agent init wizard** — auto-detects installed agents and generates per-agent MCP configs
-- **Supported agents:** Claude Code, OpenAI Codex, Gemini CLI, Cursor, VS Code Copilot, Windsurf
-- **Per-agent config writers** — `.mcp.json`, `.codex/config.toml`, `.gemini/settings.json`, `.cursor/mcp.json`, `.vscode/mcp.json`, `~/.codeium/windsurf/mcp_config.json`
+- **Supported agents:** Claude Code, OpenAI Codex, Gemini CLI, OpenCode
+- **Per-agent config writers** — `.mcp.json`, `.codex/config.toml`, `.gemini/settings.json`, `opencode.json`
+- **Agent instructions boilerplate** — `fathom-agents.md` template for memory discipline, vault conventions, cross-workspace communication
 - **Conditional hooks** — hook setup only for Claude Code (other agents don't support hooks)
 - **`agents` array** replaces legacy `architecture` string in `.fathom.json` — backward compatible
 - **Server-side agent dispatch** — persistent sessions launch the correct agent CLI per workspace

package/README.md

@@ -18,9 +18,7 @@ MCP server for [Fathom](https://hifathom.com) — vault operations, search, room
 | **Claude Code** | `.mcp.json` | `.claude/` directory |
 | **OpenAI Codex** | `.codex/config.toml` | `.codex/` directory |
 | **Gemini CLI** | `.gemini/settings.json` | `.gemini/` directory |
-| **Cursor** | `.cursor/mcp.json` | `.cursor/` directory |
-| **VS Code Copilot** | `.vscode/mcp.json` | `.vscode/` directory |
-| **Windsurf** | `~/.codeium/windsurf/mcp_config.json` | `~/.codeium/windsurf/` directory |
+| **OpenCode** | `opencode.json` | `opencode.json` file |
 
 The init wizard auto-detects which agents you have and generates the right config for each.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fathom-mcp",
-  "version": "0.2.3",
+  "version": "0.3.1",
   "description": "MCP server for Fathom — vault operations, search, rooms, and cross-workspace communication",
   "type": "module",
   "bin": {
@@ -40,9 +40,7 @@
     "claude",
     "codex",
     "gemini",
-    "cursor",
-    "copilot",
-    "windsurf",
+    "opencode",
     "ai-agent",
     "memory"
   ]

package/src/cli.js

@@ -10,7 +10,6 @@
  */
 
 import fs from "fs";
-import os from "os";
 import path from "path";
 import readline from "readline";
 import { fileURLToPath } from "url";
@@ -157,42 +156,20 @@ function writeGeminiJson(cwd) {
   return ".gemini/settings.json";
 }
 
-function writeCursorJson(cwd) {
-  const dir = path.join(cwd, ".cursor");
-  fs.mkdirSync(dir, { recursive: true });
-  const filePath = path.join(dir, "mcp.json");
-  const existing = readJsonFile(filePath) || {};
-  deepMerge(existing, { mcpServers: { "fathom-vault": MCP_SERVER_ENTRY } });
-  writeJsonFile(filePath, existing);
-  return ".cursor/mcp.json";
-}
-
-function writeVscodeJson(cwd) {
-  const dir = path.join(cwd, ".vscode");
-  fs.mkdirSync(dir, { recursive: true });
-  const filePath = path.join(dir, "mcp.json");
+function writeOpencodeJson(cwd) {
+  const filePath = path.join(cwd, "opencode.json");
   const existing = readJsonFile(filePath) || {};
   deepMerge(existing, {
-    servers: {
+    mcp: {
       "fathom-vault": {
-        type: "stdio",
-        command: "npx",
-        args: ["-y", "fathom-mcp"],
+        type: "local",
+        command: ["npx", "-y", "fathom-mcp"],
+        enabled: true,
       },
     },
   });
   writeJsonFile(filePath, existing);
-  return ".vscode/mcp.json";
-}
-
-function writeWindsurfJson(_cwd) {
-  const dir = path.join(os.homedir(), ".codeium", "windsurf");
-  fs.mkdirSync(dir, { recursive: true });
-  const filePath = path.join(dir, "mcp_config.json");
-  const existing = readJsonFile(filePath) || {};
-  deepMerge(existing, { mcpServers: { "fathom-vault": MCP_SERVER_ENTRY } });
-  writeJsonFile(filePath, existing);
-  return "~/.codeium/windsurf/mcp_config.json";
+  return "opencode.json";
 }
 
 const AGENTS = {
@@ -217,31 +194,17 @@ const AGENTS = {
     hasHooks: false,
     nextSteps: "Run `gemini` in this directory — fathom tools load automatically.",
   },
-  "cursor": {
-    name: "Cursor",
-    detect: (cwd) => fs.existsSync(path.join(cwd, ".cursor")),
-    configWriter: writeCursorJson,
-    hasHooks: false,
-    nextSteps: "Restart Cursor — fathom tools appear in MCP settings.",
-  },
-  "vscode": {
-    name: "VS Code Copilot",
-    detect: (cwd) => fs.existsSync(path.join(cwd, ".vscode")),
-    configWriter: writeVscodeJson,
-    hasHooks: false,
-    nextSteps: "Reload VS Code — fathom tools appear in Copilot.",
-  },
-  "windsurf": {
-    name: "Windsurf",
-    detect: () => fs.existsSync(path.join(os.homedir(), ".codeium", "windsurf")),
-    configWriter: writeWindsurfJson,
+  "opencode": {
+    name: "OpenCode",
+    detect: (cwd) => fs.existsSync(path.join(cwd, "opencode.json")),
+    configWriter: writeOpencodeJson,
     hasHooks: false,
-    nextSteps: "Restart Windsurf — fathom tools appear in Cascade.",
+    nextSteps: "Run `opencode` in this directory — fathom tools load automatically.",
   },
 };
 
 // Exported for testing
-export { AGENTS, writeMcpJson, writeCodexToml, writeGeminiJson, writeCursorJson, writeVscodeJson, writeWindsurfJson };
+export { AGENTS, writeMcpJson, writeCodexToml, writeGeminiJson, writeOpencodeJson };
 
 // --- Init wizard -------------------------------------------------------------
 
@@ -447,6 +410,7 @@ async function runInit() {
         vault,
         description,
         agents: selectedAgents,
+        type: selectedAgents[0] || "local",
       });
       if (regResult.ok) {
         console.log(`  ✓ Registered workspace "${workspace}" with server`);

package/src/server-client.js

@@ -104,11 +104,12 @@ export function createClient(config) {
     return request("GET", "/api/workspaces/profiles");
   }
 
-  async function registerWorkspace(name, projectPath, { vault, description, agents, architecture } = {}) {
+  async function registerWorkspace(name, projectPath, { vault, description, agents, architecture, type } = {}) {
     const body = { name, path: projectPath };
     if (vault) body.vault = vault;
     if (description) body.description = description;
     if (agents && agents.length > 0) body.agents = agents;
+    if (type) body.type = type;
     // Legacy fallback
     if (architecture && !agents?.length) body.architecture = architecture;
     return request("POST", "/api/workspaces", { body });