Wormhole 🌀

Collaborative AI Workflow Manager

Keep your AI coding agents in sync. Wormhole gives Claude Code, GitHub Copilot, and Cursor a shared memory layer—so when you switch tools mid-task, nothing gets lost.

Works across:

• 🔀 Multiple subagents within the same tool (e.g., parallel Claude tasks)
• 🔄 Different AI tools entirely (Claude ↔ Copilot ↔ Cursor)

⚠️ Disclaimer: Wormhole is an early-stage project. APIs and behavior may change, and there may be rough edges. It’s built in the open and evolving fast based on real developer feedback.

Features

• Universal Logging - Single log tool for any action type
• Event Tagging - Categorize events with tags for better organization
• Session Management - Named work sessions with isolation
• Token Optimized - Compact output, delta queries, relevance filtering
• Conflict Detection - Know when agents touch the same files
• Stale Event Rejection - Automatically filters out file edits that no longer exist in the current project state
• Web UI Visualization - View sessions, timeline events, and insights with npx wormhole ui
• Knowledge Capture & Search - Save decisions/pitfalls and surface them with intent-aware search

Quick Start

Try instantly with npx (no installation required):

npx wormhole-mcp

Minimal Workflow (token-optimized)

1. start_session
2. Pull context: search_project_knowledge + get_recent
3. Before edits: check_conflicts
4. During work: log every file_edit/cmd_run/decision/test_result/todos
5. Capture learnings: save_knowledge (decision/pitfall/convention/constraint)
6. Finish: end_session with summary

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

Web UI

Visualize your agent activity with the built-in web interface:

# Start the UI server (default port: 3000)
npx wormhole ui

# Or specify a custom port
npx wormhole ui 8080

Then open http://localhost:3000 in your browser to see:

• 📊 Dashboard - Stats on events, sessions, and agents
• ⏱️ Timeline - Visual event stream with filtering
• 📋 Sessions - All work sessions with details
• 📈 Insights - Action types and tag analytics

Installation

Option 1: npx (Recommended)

Claude Code — Add to ~/.claude/claude_code_config.json:

{
  "mcpServers": {
    "wormhole": {
      "command": "npx",
      "args": ["-y", "wormhole-mcp"]
    }
  }
}

GitHub Copilot — Add to .vscode/mcp.json in your project:

{
  "servers": {
    "wormhole": {
      "command": "npx",
      "args": ["-y", "wormhole-mcp"]
    }
  }
}

Option 2: Global Install

npm install -g wormhole-mcp

Then use "command": "wormhole-mcp" in your config.

Option 3: From Source

git clone https://github.com/fatmali/wormhole.git
cd wormhole
npm install
npm run build