editor

# 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.

[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![npm @pascal-app/core](https://img.shields.io/npm/v/@pascal-app/core?label=%40pascal-app%2Fcore)](https://www.npmjs.com/package/@pascal-app/core)
[![npm @pascal-app/viewer](https://img.shields.io/npm/v/@pascal-app/viewer?label=%40pascal-app%2Fviewer)](https://www.npmjs.com/package/@pascal-app/viewer)
[![npm @pascal-app/cli](https://img.shields.io/npm/v/@pascal-app/cli?label=%40pascal-app%2Fcli)](https://www.npmjs.com/package/@pascal-app/cli)
[![Discord](https://img.shields.io/badge/Discord-Join%20Server-5865F2?logo=discord&logoColor=white)](https://discord.gg/XRKsDcpqgS)
[![X (Twitter)](https://img.shields.io/badge/follow-%40pascal-black?logo=x&logoColor=white)](https://x.com/pascal)

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](#run-the-editor-locally).
- **Self-host it** — one container with SQLite storage. See [Self-host it](#self-host-it).
- **Embed the packages** — use the viewer or full editor in your React app. See [Use the published packages](#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).

## 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](https://editor.pascal.app/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.2