# Scrawl

> A local wireframing canvas for humans and their own agents. Edit the open canvas together; changes save automatically in browser storage or a chosen disk file.

## Documentation

- [Wireframe locally with your agent](https://scrawl.jscrate.dev/docs/getting-started): Bring your own agent to the canvas you already have open. Changes save automatically.
- [Connect a local MCP client](https://scrawl.jscrate.dev/docs/mcp): Connect Codex, Claude Code, Cursor and other MCP clients to a chosen .scrawl.json file on your computer.
- [Work with a browser agent](https://scrawl.jscrate.dev/docs/webmcp): Let an agent edit the open Scrawl tab through window.scrawl or compatible WebMCP tools.
- [Local Scrawl API reference](https://scrawl.jscrate.dev/docs/api): Read, edit, render and export one local file through validated MCP or HTTP tools.
- [Canvas tools and document model](https://scrawl.jscrate.dev/docs/canvas-tools): All supported wireframe operations, node types, library properties, variations and the coordinate system for agents.
- [Scrawl agent plugin](https://scrawl.jscrate.dev/docs/plugin): Install a local wireframing workflow for Codex and other agents.
- [Run Scrawl locally](https://scrawl.jscrate.dev/docs/self-hosting): Build the editor and run a file companion with no database or hosted collaboration service.

- [Complete docs](https://scrawl.jscrate.dev/llms-full.txt)
- [Local API schemas](https://scrawl.jscrate.dev/openapi.json)
- [Connect an agent](https://scrawl.jscrate.dev/connect)

## Continue the open canvas

Connect agent in the canvas copies an invitation for an agent with access to that existing tab. Match its document ID with window.scrawl.documentId() or scrawl_read_canvas before editing. Use window.scrawl or supported WebMCP tools; edits share the canvas store, undo history and automatic browser saves. No download, installation or companion is required. A URL alone does not identify a browser drawing: another browser profile has separate storage, and a new tab may open another document. If the original tab is unavailable, explain that browser access is needed instead of creating or importing a substitute canvas.

## Optional local file setup

Use Node.js 24 and pnpm 10 in a real checkout of https://github.com/pablostanley/squig. Run pnpm install --frozen-lockfile and pnpm build:local once. Run pnpm scrawl serve /absolute/path/canvas.scrawl.json for the local editor and HTTP MCP, or configure direct Node stdio with scripts/scrawl.ts mcp and the file path as shown in /docs/mcp. No npx scrawl package is published.

Call scrawl_local_session and send its editorUrl before drawing. The companion serves the full editor on 127.0.0.1, owns one selected file, and keeps bounded local history. Keep the process running. MCP tools have a scrawl_ prefix; HTTP tools are POST /api/v1/tools/{name} on the actual loopback origin, with the same JSON and the session token as Authorization: Bearer. There is no public writable MCP endpoint or workspace signup.

Read the current document and revision before companion edits, preserve human changes, and inspect renders. Components, all node types, atomic edits, variations, notes, comments, history/restore, measurement and SVG/PNG are local tools. Only when the user chooses to move a browser drawing to a disk file, export a copy and start the companion for that saved path. Browser storage and disk copies are separate.

Existing online canvas links support temporary read-only recovery and export. Your agent still uses its own model provider, including that provider's data handling and charges.