🗺️ ThreadMap MCP for Claude

Conversation drift visualization and forking for Claude.

Stop losing your original intent. See exactly where your conversation drifted. Fork from any point and pick up with clean context.

See it in action

Color dots on every message — live drift tracking:

Timeline panel with fork buttons at every inflection point:

Two ways to use ThreadMap

Both are in this repo. Use one or both.

Chrome Extension — Visual dots in claude.ai

The Chrome extension injects ThreadMap directly into the claude.ai interface. No config. Just install and open Claude.

Install (2 minutes)

1. Clone or download this repo
2. Open Chrome → chrome://extensions
3. Enable Developer mode (top right toggle)
4. Click Load unpacked → select the chrome-extension folder
5. Open any Claude conversation — ThreadMap activates automatically

What you see

• Color dot next to every message showing drift % from your original intent
• Sticky bar at the top with live drift status and message count
• ↺ rescan — loads all messages from long previous conversations
• timeline — full conversation map, click any row to jump to that message
• ⑂ fork — opens a new Claude chat with full context pre-loaded in the input

How forking works

1. Click ⑂ fork in the timeline or next to any message bubble
2. A new claude.ai tab opens automatically
3. The full context (origin intent + all messages up to that point) is pasted into the input
4. Review and hit Send — Claude picks up from the clean version

Chrome extension files

chrome-extension/
├── manifest.json     — Extension config (Manifest v3)
├── content.js        — Core drift engine + DOM injection
├── threadmap.css     — All injected styles
├── popup.html        — Extension popup with color legend
├── icon16.png        — Icons
├── icon48.png
└── icon128.png

Heads up: The extension uses Developer mode (load unpacked). A Chrome Web Store version is on the roadmap.

MCP Server — Claude Code integration

The MCP server adds 7 tools to Claude Code for programmatic drift tracking.

Install

claude mcp add threadmap npx threadmap-mcp

Or manually add to ~/.claude/claude_desktop_config.json:

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

Quick start

threadmap_track(sessionId="myproject", role="user", content="build me a login system with JWT auth")
→ 🔵 Blue — Drift: 0% — Origin intent set

threadmap_track(sessionId="myproject", role="user", content="the refresh token keeps expiring after 30 seconds")
→ 🟠 Orange — Drift: 63% — ⚡ INFLECTION POINT detected

threadmap_timeline(sessionId="myproject")
→ Full color-coded map of all messages with fork instructions

threadmap_fork(sessionId="myproject", messageIndex=6, branchName="jwt-debug")
→ 🌿 Branch created — clean context from messages 1–7

All 7 tools

... View full README on GitHub