Floorplan

Floorplan is an open-source plugin for Claude Code and Codex, published by haydenschmitty under the MIT license. It has Claude or Codex read a codebase and draw an interactive map in which every part, file and web request gets a plain-English name and every connection is shown. The latest release listed is version 0.3.0.

What It Is

Floorplan is a codebase visualization and onboarding tool for people who want to understand how an app fits together without reading the code. You open a project (one repo or several) in Claude Code or Codex and ask for a floorplan. Scripts scan files, imports, routes and requests, then the AI names the parts and describes each file. The result is a map written to a local floorplan/index.html that opens in the browser.

How the map is used

The map works at several zoom levels, from the whole app down to a part, a group of files, a file and its endpoints. It matches frontend web requests to the server endpoints that answer them, including across separate repos. Users can start from a screen to see the parts, requests, server code, data and outside services behind it. An Ask bar returns answers with a mini-map and walkthrough. Guided flows trace a request step by step, and a Recent work view highlights cards the AI just changed, with notes tying each change to what was asked.

Health check and blueprints

A Health check flags secrets written into code, endpoints usable without sign-in, unused files and files too large to edit safely, each with a ready-to-paste fix prompt. Floorplan can also start from a PRD or spec and draw a blueprint of a planned system, shown with dashed cards, which becomes a map of the real code once it exists.

Setup and privacy model

It requires Node.js 18+ and Claude Code or Codex, and runs on the plan you already have with no API keys. Install is through a plugin marketplace. The scan, map and local server run on your machine, and the README states there is no analytics or tracking. It writes only a floorplan/ folder, plus a section in CLAUDE.local.md in Claude Code, and neither is committed to git. A live demo maps a sample coffee-subscription app called Brewline.