Skip to content

Run Floorplan in Cursor - #128

Closed
Onivoid wants to merge 4 commits into
haydenschmitty:mainfrom
Onivoid:main
Closed

Onivoid wants to merge 4 commits into
haydenschmitty:mainfrom
Onivoid:main

Conversation

@Onivoid

@Onivoid Onivoid commented Nov 15, 2026

Copy link
Copy Markdown

What this changes

Floorplan can run as a Cursor skill without changing how Claude Code or Codex behave.

Cursor does not expand CLAUDE_SKILL_DIR, so the skill tells the agent to run the scripts from the folder that contains SKILL.md. A Cursor session is recognised from the variables Cursor sets, and the map records it. architecture.json can set "editor": "cursor" so Open in editor uses a Cursor link. A personal rule at .cursor/rules/floorplan.mdc is written only with --cursor-rules (or kept current if it already exists) and is listed in .git/info/exclude. The README gains a Cursor section, a docs link and an FAQ entry; the existing README sentences are unchanged. docs/cursor.md and .cursor-plugin/plugin.json cover install and the skill.

On a map made in Cursor, the Ask bar does not start Cursor and does not fall through to the Claude Code CLI or Codex. The question stays on the local server until ask-poll.mjs, run from the Cursor chat, posts a reply, which the page displays. Cursor is not an answering engine: its CLI is not held read-only the way claude -p and codex exec --sandbox read-only are. --engine claude or --engine codex still selects those programs, which is what Change on a blueprint needs.

No linked issue. The same change is already on the fork's main, merged in Onivoid/Showplan#1.

How I tested it

Tried on Floorplan itself: one Node repository (the skill, its scripts and its tests), not a separate frontend and backend.

  • node --test (npm test): 375 passed, 0 failed.
  • Floorplan drawn of this repo: 152/152 file descriptions, 0 unassigned code files, map server started and stopped. The generated floorplan/ folder stays gitignored.
  • In the browser, on that map: typed "What does the scan step do?" in the Ask bar, ask-poll.mjs printed the question, and the reply showed on the page with its follow-up.
  • claude plugin validate . did not run to completion. The installed Claude Code CLI crashed on Node.js v26 before it read the plugin (Cannot read properties of undefined (reading 'prototype')).

Checklist

  • No new dependencies
  • Anything the map shows people is in plain language
  • No secret values stored or printed
  • No details of a real private project in code, comments, docs or screenshots
  • npm test passes
  • claude plugin validate . passes
  • CHANGELOG.md updated, if people will notice the change

Cursor does not expand CLAUDE_SKILL_DIR, so the skill now tells the agent to run the scripts from the folder that contains SKILL.md. The scripts still find their own files from that path.

A Cursor session is recognised from the variables Cursor sets, and the map records it. The Ask bar still answers through the Claude Code CLI or Codex when one is installed. When neither is, the page and the server log say to ask in the Cursor chat, and building the map does not wait on Ask. Fix and Build copy a prompt for that chat. Open in editor can use a cursor link when architecture.json sets editor to cursor.

A personal rule at .cursor/rules/floorplan.mdc is written only with --cursor-rules, or kept current if it already exists, and is listed in .git/info/exclude. CLAUDE.local.md and AGENTS.md stay as they were.

The README gains a Cursor install section, a docs link and an FAQ entry. Existing README sentences are unchanged. docs/cursor.md covers install, the first map, Ask and the personal rule, and a Cursor plugin manifest lists the skill.
A map made in Cursor no longer falls through to the Claude Code CLI or Codex. The Ask bar keeps the question on the local server until ask-poll.mjs, run from the Cursor chat, picks it up and posts a reply the page displays. The server does not start Cursor. Cursor stays off the list of answering engines, because its CLI is not held read-only the way claude -p and codex exec --sandbox read-only are.

--engine claude or --engine codex still selects those programs, which is what Change on a blueprint needs. Maps made in Claude Code or Codex are unchanged.

The Cursor guide, the safety notes and the README's Cursor section say to leave the poll running, and that the chat itself is not locked into a read-only sandbox.
@Onivoid

Onivoid commented Nov 16, 2026 •

Copy link
Copy Markdown
Author

@haydenschmitty I've resolve the conflicts that only concern 2 markdown files, don't forget to check it before approve to keep your documentation clear 😉
The commit is this one : 7fa800e

@Onivoid Onivoid closed this Nov 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant