wormhole

Wormhole

Shared memory for AI agents. Log every significant action so others stay in sync.

🚨 Minimal Workflow

Use the absolute path of the current project directory for every project_path (e.g., /Users/you/Code/wormhole). Avoid ..

1. start_session when you begin.
2. Pull context: search_project_knowledge + get_recent.
3. Before edits: check_conflicts on files.
4. During work: log every file_edit, cmd_run, decision, test_result, todos.
5. Capture learnings: save_knowledge (decisions/pitfalls/conventions/constraints).
6. Finish with end_session + summary.

✅ Logging Rules (no exceptions)

• After editing any file (include file_path + diff).
• After running commands (command + exit_code).
• After decisions, test results, todos, plan_output, feedback.

Core tools (compact)

start_session

start_session({ project_path: "/absolute/path/to/project", agent_id: "github-copilot", name: "task-name" })

log (use most)

log({
  action: "file_edit",
  agent_id: "github-copilot",
  project_path: "/absolute/path/to/project",
  content: {
    file_path: "src/auth.ts",
    description: "Add JWT validation",
    diff: "--- a/src/auth.ts\n+++ b/src/auth.ts\n@@ ..."
  },
  tags: ["auth"]
})

Other actions: cmd_run, decision, test_result, todos, plan_output, feedback.

get_recent

get_recent({ project_path: "/absolute/path/to/project", related_to: ["src/auth.ts"] })

check_conflicts

check_conflicts({ project_path: "/absolute/path/to/project", files: ["src/auth.ts"] })

search_project_knowledge (pull context)

search_project_knowledge({ project_path: "/absolute/path/to/project", intent: "debugging", query: "auth" })

save_knowledge (store learnings)

save_knowledge({
  project_path: "/absolute/path/to/project",
  knowledge_type: "pitfall",
  title: "Avoid fs.readFileSync in handlers",
  content: "Blocks event loop; causes timeouts"
})

end_session

end_session({ session_id: "abc-123", summary: "Fixed auth timeout; tests pass" })

📋 Tiny workflow

start_session({ project_path: "/absolute/path/to/project", agent_id: "github-copilot", name: "fix-auth" })
search_project_knowledge({ project_path: "/absolute/path/to/project", intent: "debugging", query: "auth" })
get_recent({ project_path: "/absolute/path/to/project" })
check_conflicts({ project_path: "/absolute/path/to/project", files: ["src/auth.ts"] })
log({ action: "file_edit", agent_id: "github-copilot", project_path: "/absolute/path/to/project", content: { file_path: "src/auth.ts", description: "Fix timeout" } })
log({ action: "cmd_run", agent_id: "github-copilot", project_path: "/absolute/path/to/project", content: { command: "npm test", exit_code: 0 } })
save_knowledge({ project_path: "/absolute/path/to/project", knowledge_type: "decision", title: "Use async DB client", content: "Prevents blocking" })
end_session({ session_id: "abc-123", summary: "Auth fixed; tests green" })