Skip to content

QuinnAho/claudemap

Welcome to...

ClaudeMap

Version License: MIT npm downloads GitHub stars

Google Maps for vibecoders.

AI lets you build faster than ever, but the very tools that help our productivity are leaving us behind - you don't understand what you're building anymore. You can vibecode a full app in a weekend and not even start to explain how it works. ClaudeMap fixes that.

Unlike traditional visualization tools, ClaudeMap organizes your code by what it actually does. Claude reads your project and groups it into concepts in a way you actually think about your project. Zoom out to see the big picture. Zoom in to see the details. Colors show what's healthy and what's broken. Use /explain and ask any question about your code, Claude will present directly on the map and explain step by step. Use /show to tell Claude what you want to find or see, and it moves the map for you.

All powered by the same AI you vibecode with.

See It In Action

ClaudeMap Demo

Try the map (standalone preview, Claude features require Claude Code or Codex)

Longer YouTube walkthrough

Install

npx @quinnaho/claudemap install
claude
/setup-claudemap

Codex support is here!npx @quinnaho/claudemap install --assistant codex - see Codex guide.

In Codex, run /skills, choose codexmap-runtime, or prefix natural-language requests with $codexmap-runtime, for example:

$codexmap-runtime build the initial map for this repo

Commands

Command Description
/setup-claudemap Analyze your repo and generate the map
/refresh Update map after code changes
/explain AI-guided walkthroughs with visual highlighting
/show Navigate the map with natural language

What's New in v0.2.0

  • Sub-map support - create scoped maps for larger codebases
  • Codex support - works with Claude Code and OpenAI Codex
  • Stable map generation - consistent layouts across rebuilds
  • Iterative refinement - tweak your map without starting over
  • Better refresh UX - smoother updates after code changes

Learn More

License

MIT