ClaudeMap

Floorplan

A Claude Code plugin that reads your codebase and draws an interactive, plain-English map of how your app actually fits together.

Plugins & Agentsclaude-codepluginvisualizationlocal-first

Ask for a floorplan and plain-Node scripts with zero dependencies scan your files, imports, routes and web requests, while Claude or Codex names the parts and describes every file. The result is a local floorplan/index.html you can zoom from app to part to file to endpoint, ask questions on (answers come with a mini-map and a step-by-step walkthrough), and refresh as you work — updates re-read only what changed, and the cards you just touched light up under Recent work. A health check flags secrets written into code, endpoints callable without signing in, unused files and files too big to edit safely, each with a ready-to-paste fix. Everything runs on your machine; the floorplan/ folder ignores itself in git, and nothing you track is ever modified.

What it does

  • A map at every zoom — start with the whole app, then double-click into a part, a group of files, a file and its endpoints; each view shows what it's used by and what it uses, and you can start from a screen you know and see everything behind it, down to the database and outside services
  • Real connections, across repos — it follows imports and matches each web request in your frontend to the server endpoint that answers it, over a monorepo, a subfolder of one, or a folder holding several repos side by side
  • Ask the map and guided flows — "How does a refund reach the customer's card?" returns an answer plus a mini-map of just the pieces involved with a step-by-step walkthrough, and new flows can be requested in plain words
  • Health check and recent work — finds passwords in code, endpoints anyone can use without signing in, unused files and files too big to edit safely, each with a ready-to-paste fix; cards your AI just changed light up green with a note on how the change serves what you asked for

When to use it

The diagram nobody drew for apps built with heavy AI help: builders who want to understand their own app in plain words without reading the code, teams onboarding someone from the big picture down to the exact file, and anyone who wants to see which parts a change touched. Parsing covers TypeScript, JavaScript, Python, Go, Rust, Java, Kotlin, Scala plus Vue, Svelte and Astro files (lighter support for others); endpoint detection spans Express, Next.js, Flask, FastAPI, Django, Spring and more; screen detection spans Next.js, React Router, SvelteKit, Expo and more.

Getting started

claude plugin marketplace add haydenschmitty/floorplan
claude plugin install floorplan@floorplan

Requires Node.js 18+ and Claude Code (or Codex — the same plugin: codex plugin marketplace add haydenschmitty/floorplan, then codex plugin add floorplan@floorplan). Runs on the plan you already have, with no API keys.

Things to know

Early software — version 0.2.1. A first map takes minutes for a small app and longer for a big one (big projects are split across parallel helpers), and it uses your existing Claude or ChatGPT plan like any other task. The map's Ask bar answers through the Claude Code CLI or Codex, which can read your real code; without the CLI you can still ask from the Claude app using the map alone. It only writes its own floorplan/ folder (plus a short section in CLAUDE.local.md on Claude Code) and neither is committed; the README mentions a one-time prompt asking whether you want an email when Floorplan Cloud launches — nothing is sent unless you sign up.

Repository

haydenschmitty/floorplan

Charted

Related on the map

  • clawd-conduit

    Plugin / Agent

    Wire all 15 Claude Code hook events into the Clawd on Desk desktop pet — and turn permission requests into a blocking desktop card.

    • hooks
    • desktop
    • notifications
    • claude-code
  • CometixCode

    Plugin / Agent

    An unofficial Rust 1:1 reimplementation of the Claude Code terminal UI, ported file-for-file onto an iocraft TUI framework.

    • terminal-ui
    • rust
    • reimplementation
    • unofficial
  • Abide

    Plugin / Agent

    Hook-level enforcement for the natural-language rules in AGENTS.md and CLAUDE.md — every edit is judged and violations are repaired in the same turn.

    • hooks
    • code-review
    • rules
    • agents-md