关键字 · FLOORPLAN
Floorplan: let Claude or Codex read your code and draw a clickable map of your whole app
Free open-source plugin: Claude Code or Codex reads your codebase and draws an interactive map of your app in plain English, with Q&A and a health check.
You built an app, probably with a lot of help from AI, and it works. But if someone asks "what happens when a user checks out?" or "what breaks if I change this?", the honest answer might be: no idea. Floorplan is made for exactly that. Claude Code or Codex reads your code, and a few minutes later you get a map you can explore, ask questions on, and keep up to date as you work.
It's open source (MIT license), made by haydenschmitty, and has around 4,700 stars on GitHub.
01What it is and what you get
Floorplan is a plugin for Claude Code and Codex. It scans your code, gives every part, file and web request a plain-English name, and draws every connection between them. The main features:
- A map at every zoom level: start with the whole app, then double-click into a part, a group of files, a file and its endpoints. Each view shows what uses it and what it uses.
- Plain English everywhere: "Takes card payments at checkout", not "Stripe API wrapper". Technical terms are explained on hover, and one switch shows the developer view.
- Real connections, even across repos: it follows imports and matches each web request in your frontend to the server endpoint that answers it, even when they live in separate repos.
- Start from a screen: pick a page you know and see everything behind it, from its parts and requests to the server code, data and outside services.
- Ask the map: "How does a refund reach the customer's card?" comes back as an answer plus a mini-map of just the pieces involved, with a step-by-step walkthrough.
- Health check: it catches classic mistakes in AI-built apps, like keys in the code, Supabase tables anyone can read, open Firebase rules, Stripe webhooks anyone could fake and endpoints with no sign-in. Each one comes with a ready-to-paste fix. It's a check, not an audit.
- Recent work: the cards your AI just changed light up green, each with a note on how the change serves what you asked for.
No code yet? It can also start from a PRD, a spec or a description and draw a blueprint: the same kind of map, showing every part, file, endpoint and screen you'd need. Blueprint cards are dashed so you know it's a plan.
02What you need
- Node.js 18 or newer.
- Either Claude Code or Codex.
- No API keys: it runs on the Claude or ChatGPT plan you already have.
03How to install
Claude Code (the desktop app's Code tab or the CLI), run these two commands:
- claude plugin marketplace add haydenschmitty/floorplan
- claude plugin install floorplan@floorplan
Then start a new session and it's ready. Even if you use the desktop app, the author recommends installing the Claude Code CLI too, because the map's Ask bar uses it to read your real code.
Codex (signed in with ChatGPT, no terminal needed): in the Codex app open Plugins, choose Add a marketplace, enter haydenschmitty/floorplan as the Source, click Add marketplace, then find Floorplan and click + to install it. Or, from a terminal:
- codex plugin marketplace add haydenschmitty/floorplan
- codex plugin add floorplan@floorplan
04How to use it
- Step 1: open your project in Claude Code or Codex. If your frontend and backend are in separate repos, open the folder that holds both.
- Step 2: ask "Make me a floorplan of this app." (In Codex you can also type $floorplan.)
- Step 3: explore. The map opens on its own, starting with a short tour.
- Step 4: after more work, ask "Update the floorplan." Only what changed is re-read, and what you just worked on lights up under Recent work.
05Good to know
- What it adds to your project: a floorplan/ folder holding the map, and in Claude Code (if you say yes) a short section in CLAUDE.local.md. Neither is committed to git.
- Privacy: the scan, the map and its small local server all run on your computer, and the server only accepts connections from your own machine. No analytics or tracking. The health check only shows where secrets are, never their values.
- Safety: no hooks, no MCP servers, no dependencies, and it downloads nothing. Its only outside request is an opt-in waitlist.
- Time and cost: a first map takes a few minutes for a small app and longer for a big one, since every file and endpoint gets described. It uses your Claude or ChatGPT plan like any other task.
- It understands many languages, including TypeScript, JavaScript, Python, Go, Rust, Java, Swift, C# and PHP.
- License: MIT, free and open source.
06Links
What is the next useful tool?
Every video has a full guide. Follow @serrinion to see new ones first.