traverse

traverse

interactive code walkthrough diagrams via MCP. share them with anyone.

The canonical repo for this is hosted on tangled over at dunkirk.sh/traverse

try it now

bunx @taciturnaxolotl/traverse

requires bun. runs an MCP server on stdio and a web server on localhost:4173.

setup

add to your MCP client:

claude code:

claude mcp add traverse -- bunx @taciturnaxolotl/traverse

claude desktop — add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "traverse": {
      "command": "bunx",
      "args": ["@taciturnaxolotl/traverse"]
    }
  }
}

other MCP clients — same JSON config, wherever your client reads .mcp.json or equivalent.

your AI calls the walkthrough_diagram tool with mermaid code + node descriptions, and you get a clickable diagram in your browser.

diagrams persist to sqlite at ~/Library/Application Support/traverse/traverse.db (macOS) or $XDG_DATA_HOME/traverse/traverse.db (linux). override with TRAVERSE_DATA_DIR.

sharing

click the share button on any diagram to upload it to traverse.dunkirk.sh and copy a public link.

configure the share server in ~/Library/Application Support/traverse/config.json:

{
  "shareServerUrl": "https://traverse.dunkirk.sh"
}

or set TRAVERSE_SHARE_URL.

server mode

run your own share server:

TRAVERSE_MODE=server bun run src/index.ts

accepts POST /api/diagrams with a diagram JSON body, returns { id, url }.

env vars

© 2026-present Kieran Klukas