The map is open without a way to ask questions. Either:
- install the Claude Code CLI, sign in, then ask Claude to update the floorplan or run
node floorplan/serve.mjs; - or open the map in the Claude app: ask Claude to "publish my floorplan to the Claude app". Answers there come from the map only.
serve.mjs looks for claude on your PATH and in ~/.local/bin. If it lives somewhere else:
node floorplan/serve.mjs --claude /path/to/claudeThe map's server looks for codex on your PATH and, on Windows, for the CLI that comes with the Codex desktop app. Install the Codex CLI, or point the server at yours:
node floorplan/serve.mjs --codex /path/to/codexIf it says Codex isn't signed in, open the Codex app (or run codex login) and sign in with ChatGPT. More in Floorplan in Codex.
Codex runs commands in a sandbox, and the map's server needs to keep running and reach the network. Allow the server to run outside the sandbox when Codex asks, or run node floorplan/serve.mjs yourself from the project folder.
Install Node.js 18 or newer, then start a new session so Claude Code or Codex picks it up.
In Claude Code, Floorplan pre-approves its own scripts while it's running, but it may still ask in some setups. Choose the option to always allow them for this project. Codex asks according to your approval settings; allowing Floorplan's node scripts for the project stops the prompts.
Plugins load when a session starts, so start a new one after installing. Check that it's installed and enabled:
claude plugin listPlain requests like "make me a floorplan" work without the slash command. If you do want it, it's /floorplan:floorplan.
In Codex, check Plugins in the app, or run codex plugin list, and start a new chat after installing. To call it by name, type $floorplan.
Ask Claude or Codex to "update the floorplan". If a tab was already open, it reloads itself once the update finishes.
Maps made before version 0.1.3 load their layout engine from the internet, so check your connection or any content blocker, or ask Claude to "update the floorplan". Newer maps have everything built in and work offline.
Floorplan finds most web requests and imports by reading the code, but not all of them, for example requests to an address that only exists in settings. Ask Claude to add the missing connection to the floorplan; it records it in architecture.json and it stays on every update.
Ask Claude to move it, or edit the paths patterns in floorplan/architecture.json and ask for an update.
Your project has its own folder called floorplan, which Floorplan won't write into. Rename your folder, or ask Claude to build the map somewhere else; the scan and build scripts accept --out <folder>.
They were committed before Floorplan started ignoring the folder. Untrack them, keeping the files on disk:
git rm -r --cached floorplanNothing to do. The server moves to the next free port, and the URL it prints, or that Claude gives you, is the right one.
node floorplan/serve.mjs --stopIt also stops by itself two hours after the last tab closes.
Open an issue with what you asked, what happened, whether you used Claude Code or Codex, and the output it showed. Please leave out anything private from your code.