{
  "markdown": "# 🗺️ ThreadMap MCP for Claude\n\n**Conversation drift visualization and forking for Claude.**\n\n> Stop losing your original intent. See exactly where your conversation drifted. Fork from any point and pick up with clean context.\n\n---\n\n## See it in action\n\n**Color dots on every message — live drift tracking:**\n\n![ThreadMap drift dots demo](docs/threadmap-demo.gif)\n\n**Timeline panel with fork buttons at every inflection point:**\n\n![ThreadMap timeline panel](docs/threadmap-timeline.gif)\n\n---\n\n## Two ways to use ThreadMap\n\n| | MCP Server | Chrome Extension |\n|---|---|---|\n| **Works in** | Claude Code (terminal) | claude.ai (browser) |\n| **Install** | `claude mcp add threadmap npx threadmap-mcp` | Load unpacked from `chrome-extension/` folder |\n| **What you get** | 7 tools — track, timeline, fork, branch | Color dots on every message, timeline panel, one-click fork |\n| **Best for** | Developers building with Claude Code | Anyone using claude.ai daily |\n\nBoth are in this repo. Use one or both.\n\n---\n\n## Chrome Extension — Visual dots in claude.ai\n\nThe Chrome extension injects ThreadMap directly into the claude.ai interface. No config. Just install and open Claude.\n\n### Install (2 minutes)\n\n```\n1. Clone or download this repo\n2. Open Chrome → chrome://extensions\n3. Enable Developer mode (top right toggle)\n4. Click Load unpacked → select the chrome-extension folder\n5. Open any Claude conversation — ThreadMap activates automatically\n```\n\n### What you see\n\n- **Color dot** next to every message showing drift % from your original intent\n- **Sticky bar** at the top with live drift status and message count\n- **↺ rescan** — loads all messages from long previous conversations\n- **timeline** — full conversation map, click any row to jump to that message\n- **⑂ fork** — opens a new Claude chat with full context pre-loaded in the input\n\n### How forking works\n\n1. Click **⑂ fork** in the timeline or next to any message bubble\n2. A new claude.ai tab opens automatically\n3. The full context (origin intent + all messages up to that point) is pasted into the input\n4. Review and hit Send — Claude picks up from the clean version\n\n### Chrome extension files\n\n```\nchrome-extension/\n├── manifest.json     — Extension config (Manifest v3)\n├── content.js        — Core drift engine + DOM injection\n├── threadmap.css     — All injected styles\n├── popup.html        — Extension popup with color legend\n├── icon16.png        — Icons\n├── icon48.png\n└── icon128.png\n```\n\n> **Heads up:** The extension uses Developer mode (load unpacked). A Chrome Web Store version is on the roadmap.\n\n---\n\n## MCP Server — Claude Code integration\n\nThe MCP server adds 7 tools to Claude Code for programmatic drift tracking.\n\n### Install\n\n```bash\nclaude mcp add threadmap npx threadmap-mcp\n```\n\nOr manually add to `~/.claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"threadmap\": {\n      \"command\": \"npx\",\n      \"args\": [\"threadmap-mcp\"]\n    }\n  }\n}\n```\n\n### Quick start\n\n```\nthreadmap_track(sessionId=\"myproject\", role=\"user\", content=\"build me a login system with JWT auth\")\n→ 🔵 Blue — Drift: 0% — Origin intent set\n\nthreadmap_track(sessionId=\"myproject\", role=\"user\", content=\"the refresh token keeps expiring after 30 seconds\")\n→ 🟠 Orange — Drift: 63% — ⚡ INFLECTION POINT detected\n\nthreadmap_timeline(sessionId=\"myproject\")\n→ Full color-coded map of all messages with fork instructions\n\nthreadmap_fork(sessionId=\"myproject\", messageIndex=6, branchName=\"jwt-debug\")\n→ 🌿 Branch created — clean context from messages 1–7\n```\n\n### All 7 tools\n\n| Tool | What it does |\n|------|-------------|\n| `threadmap_track` | Track a message, get drift score + color |\n| `threadmap_timeline` | Full color-coded conversation map |\n| `threadmap_fork` | Fork from any message index |\n| `threadmap_branch_context` | Clean context packet for any branch |\n| `threadmap_status` | Quick current drift check |\n| `threadmap_reset` | Archive thread, start fresh |\n| `threadmap_legend` | Show color reference guide |\n\n---\n\n## Color system\n\n| Color | Drift | Meaning |\n|-------|-------|---------|\n| 🔵 Blue | 0–15% | On track — core intent |\n| 🟢 Green | 16–35% | Productive expansion |\n| 🟡 Yellow | 36–55% | Adjacent drift |\n| 🟠 Orange | 56–72% | **Inflection point** — meaningful pivot |\n| 🔴 Red | 73–88% | Full context break |\n| 🟣 Purple | 89–95% | Meta — talking about the conversation |\n| ⚪ White | 96–100% | Resolution |\n\nOrange and Red = fork candidates. The conversation has left your original intent behind.\n\n---\n\n## Real-world use cases\n\n**Claude Code — architecture integrity**\nTrack every message while building. Orange = scope creep. Fork before the drift gets worse. Architecture decisions from the first 10 messages stay clean.\n\n**Long previous conversations**\nClick ↺ rescan in the Chrome extension. ThreadMap scrolls to the top, loads all messages, scans every one, then returns you to the bottom — all dots appear.\n\n**Team handoffs**\nUse `threadmap_branch_context` to extract a clean summary of what was decided. Paste it into a new session — no scrolling through 200 messages.\n\n---\n\n## Why open source?\n\nNon-linear conversation navigation is the missing primitive for AI-native work. Right now Claude conversations are books with no table of contents, no chapters, no bookmarks.\n\nThreadMap is the table of contents. If this becomes the standard, it travels across Claude, GPT, Gemini, anything. Nobody owns it. Everybody benefits.\n\n---\n\n## Roadmap\n\n- [ ] Local embedding model (MiniLM) for richer semantic scoring\n- [ ] Chrome extension on Chrome Web Store (no developer mode required)\n- [ ] Cross-session persistence (SQLite mode)\n- [ ] Visual timeline export (SVG/HTML)\n- [ ] GPT / Gemini compatibility\n\n---\n\n## Contributing\n\nMIT licensed. See [CONTRIBUTING.md](./CONTRIBUTING.md).\n\n```bash\ngit clone https://github.com/Advertflair/threadmap-mcp\ncd threadmap-mcp\nnpm install\nnpm run build\n```\n\nPRs welcome especially for: better drift scoring, Chrome extension improvements, and other AI platform support.\n\n---\n\n## License\n\nMIT — see [LICENSE](./LICENSE)\n\n---\n\n*Built by [Advertflair](https://advertflair.com). Open source. Ship it.*\n",
  "bytes": 6134,
  "sha": "45a379f98781fd86961ebdbaafebb18c60d3ce8817aacfc61a31cf1429666797",
  "repo_slug": "advertflair/threadmap-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_advertflair_threadmap_mcp_d29fa1ce/readme"
}