fathom-mcp 0.4.11 → 0.4.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fathom-mcp",
-  "version": "0.4.11",
+  "version": "0.4.12",
   "description": "MCP server for Fathom — vault operations, search, rooms, and cross-workspace communication",
   "type": "module",
   "bin": {

package/src/cli.js

@@ -129,7 +129,7 @@ function copyScripts(targetDir) {
 // --- Headless agent integration ----------------------------------------------
 
 const HEADLESS_CMDS = {
-  "claude-code": (prompt) => ["claude", "-p", prompt],
+  "claude-code": (prompt) => ["claude", "-p", "--dangerously-skip-permissions", prompt],
   "codex":       (prompt) => ["codex", "exec", prompt],
   "gemini":      (prompt) => ["gemini", prompt],
   "opencode":    (prompt) => ["opencode", "run", prompt],
@@ -679,12 +679,13 @@ async function runInit(flags = {}) {
     } else {
       if (cmdParts) {
         const [cmd, ...args] = cmdParts;
-        const displayCmd = `${cmd} ${args[0]}${args.length > 1 ? " ..." : ""}`;
+        const flagArgs = args.slice(0, -1).join(" ");
+        const displayCmd = `${cmd} ${flagArgs} <prompt>`;
         const rl2 = readline.createInterface({ input: process.stdin, output: process.stdout });
         console.log("\n" + "─".repeat(60));
         const integrate = await askYesNo(
           rl2,
-          `\n  Auto-integrate instructions into your project?\n  This will run: ${displayCmd}\n\n  Proceed?`,
+          `\n  Auto-integrate instructions into your project?\n  This will run: ${displayCmd}\n\n  ⚠  This uses --dangerously-skip-permissions so the agent can\n  write to CLAUDE.md without prompting. If you prefer, decline\n  and we'll print the instructions for you to add manually.\n\n  Proceed?`,
           true,
         );
         rl2.close();

package/src/index.js

@@ -209,8 +209,8 @@ const tools = [
       "Post a message to a shared room. Rooms are created implicitly on first post. " +
       "Use this for ambient, multilateral communication — unlike fathom_send (point-to-point DM), " +
       "room messages are visible to all participants. Responding is optional — use `<...>` for active silence. " +
-      "Supports @workspace mentions (e.g. @fathom, @navier-stokes) — mentioned workspaces get the message " +
-      "injected into their Claude session, same mechanism as fathom_send. Use @all to notify every workspace except sender.",
+      "Supports @workspace mentions (e.g. @fathom, @navier-stokes) — mentioned workspaces receive " +
+      "notifications in their mentions:{workspace} virtual room via fathom_room_list. Use @all to notify every workspace except sender.",
     inputSchema: {
       type: "object",
       properties: {
@@ -227,7 +227,9 @@ const tools = [
       "to the latest message. Default: 60 minutes before the latest message. Use start to look " +
       "further back. Example: minutes=15, start=120 returns 15 minutes of conversation starting " +
       "2 hours before the latest message. Response includes window metadata with has_older flag " +
-      "for pseudo-pagination. Automatically marks the room as read for this workspace unless mark_read=false.",
+      "for pseudo-pagination. For virtual rooms (dm:*, mentions:*), messages are consumed on read — " +
+      "deleted after being returned. Use mark_read=false to peek without consuming. " +
+      "For regular rooms, automatically marks as read unless mark_read=false.",
     inputSchema: {
       type: "object",
       properties: {
@@ -244,7 +246,8 @@ const tools = [
     description:
       "List all rooms with activity summary — message count, last activity time, last sender, " +
       "description, and per-room unread_count for this workspace. Use to discover active rooms " +
-      "and see which have new messages.",
+      "and see which have new messages. Virtual rooms (dm:{workspace}, mentions:{workspace}) " +
+      "appear only for the owning workspace and disappear when empty.",
     inputSchema: {
       type: "object",
       properties: {},
@@ -279,9 +282,10 @@ const tools = [
   {
     name: "fathom_send",
     description:
-      "Send a message to another workspace's agent instance — for cross-workspace coordination, " +
-      "sharing findings, or requesting action. Use fathom_workspaces first to discover valid " +
-      "targets. The target agent sees: 'Message from workspace ({from}): {message}'",
+      "Send a message to another workspace's agent instance — stored in their dm:{workspace} " +
+      "virtual room. Use fathom_workspaces first to discover valid targets. Recipients see DMs " +
+      "via fathom_room_list and consume them with fathom_room_read. " +
+      "Message format: 'Message from workspace ({from}): {message}'",
     inputSchema: {
       type: "object",
       properties: {