Wormhole
Wormhole MCP: Collaborative AI Workflow Manager🌀
npx -y skills add fatmali/wormhole --skill wormholeAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 11 stars11 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Sync work between AI agents. Log actions, manage sessions, detect conflicts.
SKILL.md
3.1 KB, 792 tokens by cl100k_base, as published. Nobody here has run it
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..
start_sessionwhen you begin.- Pull context:
search_project_knowledge+get_recent. - Before edits:
check_conflictson files. - During work:
logevery file_edit, cmd_run, decision, test_result, todos. - Capture learnings:
save_knowledge(decisions/pitfalls/conventions/constraints). - 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" })
What ships with it
Read from the repository
Just SKILL.md. No reference files, no scripts.