README

Pascal Editor — open-source 3D architecture software for AECO

Create and edit 3D building models in your browser, run Pascal locally with its CLI, or connect
AI agents through the Model Context Protocol (MCP).

Pascal Editor is a local-first, MIT-licensed building editor for architecture, engineering,
construction, and operations (AECO) work. Model sites, buildings, levels, walls, slabs, roofs,
openings, rooms, and furniture; bring 3D scans in as reference layers for scan-to-BIM workflows
and model editable building elements over them; and let an agent read, edit, validate, and save
the same scenes. Built with React Three Fiber and WebGPU.








https://github.com/user-attachments/assets/063c0891-9ae5-4173-bd08-a101d9c3352b

 Start here

- Run the editor locally — npx @pascal-app/cli editor. See Run the editor locally.
- Self-host it — one container with SQLite storage. See Self-host it.
- Embed the packages — use the viewer or full editor in your React app. See Use the published packages.
- Connect an AI agent — Claude Code, Cursor, Codex, or any MCP client. See Connect an AI agent (MCP).

 Connect an AI agent (MCP)

MCP is an open protocol that lets AI assistants call tools in other applications; Pascal's MCP
server gives an agent tools to inspect, edit, validate, and save building scenes.

Choose where the projects live:

- Local (no account) — the Pascal CLI runs an MCP service on your machine. Agents connect
  with pascal mcp connect, projects stay in ~/.pascal/data/pascal.db, and nothing is uploaded.
  No Pascal account or API key is needed.
- Hosted workspace — https://editor.pascal.app/api/mcp works in your Pascal account or
  organization and needs that account's authorization. How a client authenticates depends on the
  client: the Cursor plugin uses browser sign-in, while Claude Code, Codex, and other clients send
  an API key created in Pascal Settings. Some hosted
  operations, such as Architect runs, consume Pascal credits.

The local commands below need the pascal command on your PATH (Node.js 22.23.4+ on 22.x,
24.22.1+ on 24.x, or 26.12.1+):

bash
npm install --global @pascal-app/cli


 [!IMPORTANT]
 Use one active agent client per local CLI service. The standalone local HTTP runtime shares
 active scene state between clients; use separate PASCAL_HOME directories and service
 processes when independent concurrent work is required. The hosted endpoint uses a separate
 session-isolated bridge.

 Claude Code

Register the local server (this runs claude mcp add --scope user pascal -- pascal mcp connect):

bash
pascal mcp setup claude


Or install the plugin, which bundles the skills, the local pascal server, and a hosted
pascal-hosted server that prompts for an optional Pascal API key and stores it in the OS
keychain (leave it empty to stay local-only):

text
/plugin marketplace add pascalorg/editor
/plugin install pascal-agent-skills@pascal


Use one or the other. Claude Code 2.1.258 loads both the user-scoped pascal server create