OpenPencil

The world's first open-source AI-native vector design tool.
_{Concurrent Agent Teams • Design-as-Code • Built-in MCP Server • Multi-model Intelligence}

English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Français · Español · Deutsch · Português · Русский · हिन्दी · Türkçe · ไทย · Tiếng Việt · Bahasa Indonesia

_{Click the image to watch the demo video}

Why OpenPencil

OpenPencil × Infistar.cc 无限星河｜全模型 API · 驱动 AI 原生设计创作

感谢 Infistar.cc 无限星河赞助并为 OpenPencil 提供模型服务支持！

⚡ 稳定承载复杂设计任务： 提供企业级高并发通道与多节点冗余，价格低至官方渠道 1 折，稳定支持长任务、流式响应与连续工具调用。
🧠 一个 API Key 接入主流模型： 全面支持 ChatGPT、Claude、Gemini、Kimi、GLM、DeepSeek 等模型，兼容 OpenAI、Anthropic 等主流接口，可在 OpenPencil 中灵活配置模型服务。
🎨 赋能 AI 原生矢量设计： 适用于提示词生成设计、画布内容修改、多模型协同、图片生成及设计方案迭代，让 AI Agent 更高效地完成从创意到成稿的全过程。
🎁 OpenPencil 用户专属福利： 通过专属推广链接注册并完成首次调用，即可领取 5 美元等值测试额度 / 首充专属优惠！

🎨 Prompt → Canvas

Describe any UI in natural language. Watch it appear on the infinite canvas in real-time with streaming animation. Modify existing designs by selecting elements and chatting.

🤖 Concurrent Agent Teams

The orchestrator decomposes complex pages into spatial sub-tasks. Multiple AI agents work on different sections simultaneously — hero, features, footer — all streaming in parallel with per-member canvas indicators.

🧠 Multi-Model Intelligence

Automatically adapts to each model's capabilities. Claude gets full prompts with thinking; GPT-4o/Gemini disable thinking; smaller models (MiniMax, Qwen, Llama) get simplified prompts for reliable output.

🔌 MCP Server

One-click install into Claude Code, Codex, OpenCode, Kiro, or Copilot CLIs. Design from your terminal — read, create, and modify .op files through any MCP-compatible agent.

🎨 Style Guides

Built-in style guide library with tag-based fuzzy matching. Apply visual styles (glassmorphism, brutalist, retro, etc.) to AI-generated designs. MCP tools for external agent access.

📦 Design-as-Code

.op files are JSON — human-readable, Git-friendly, diffable. Design variables generate CSS custom properties. Code export to React + Tailwind or HTML + CSS.

🖥️ Runs Everywhere

Web app + native desktop on macOS, Windows, and Linux — one Rust core, a single self-contained binary, no browser engine. .op file association — double-click to open.

⌨️ CLI — `op`

Control the design tool from your terminal. op design, op insert — batch design DSL, node manipulation. Pipe in from files or stdin. Works with desktop app or web server.

🎯 Multi-Platform Code Export

Export to React + Tailwind, HTML + CSS, Vue, Svelte, Flutter, SwiftUI, Jetpack Compose, React Native — all from one .op file. Design variables become CSS custom properties.

🧩 Embeddable SDK

op-web-sdk (vanilla) + op-web-sdk-react / op-web-sdk-vue adapters — embed a read-only .op viewer in your own app, powered by the same wasm renderer the editor ships.

🛡️ Design System Kit

Manage reusable UIKits with style switching and component composition. Import/export kits from .pen files. Built-in registry with MCP tools for external access.

👥 Real-Time Collaboration

Design together over authenticated peer-to-peer sessions with a public relay and built-in regional hubs. Join with a short pairing code, see live remote cursors, and resolve conflicts with per-edit detail and replay.

Install

Building from source on Windows: see BUILD_WINDOWS.md

macOS (Homebrew):

bash
brew tap zseven-w/openpencil
brew install --cask openpencil

Windows (Scoop):

powershell
scoop bucket add openpencil https://github.com/zseven-w/scoop-openpencil
scoop install openpencil

Linux / Windows direct download: GitHub Releases — .exe (Windows), .AppImage / .deb (Linux)

The Windows .exe installer, both Scoop packages, and the install-op.ps1 CLI installer check and, when needed, service the pinned, Microsoft-signed Visual C++ v14 runtime during every install or upgrade. The portable Windows .zip archives and Windows VSIX packages do not run an elevated system installer; install Microsoft's latest supported Visual C++ Redistributable before using those artifacts directly.

Antivirus flagged the Windows installer? That's a known heuristic false positive on new, low-prevalence releases — see how to verify your download.

Nix (Linux x86_64):

bash
nix develop
nix run .                         # launch the desktop app
nix build .#openpencil            # native web host + CanvasKit web bundle
nix build .#op-cli                # the `op` CLI
nix build .#prebuilt              # use the matching upstream desktop archive
nix build .#prebuilt-cli          # use the matching upstream CLI archive
nix build .#web-server            # native GL-free web server + web bundle
nix build .#runtime-prebuilt      # prebuilt desktop + `op` CLI runtime
nix build .#web-sdk-packages      # npm tarballs for the web SDKs
nix build .#appimage              # portable desktop AppImage

The flake uses the pinned Rust toolchain from rust-toolchain.toml and is currently published for x86_64-linux. A Debian package is not produced by the flake yet; use the upstream release artifacts when a .deb is required. The prebuilt outputs use the release version and hashes pinned in nix/release-manifest.json, independently of the workspace source version. After a release is published, the release workflow opens a PR to refresh that manifest. Until it is merged, the prebuilt outputs continue to use the prior published release; the source-built outputs always build the checked-out source.

CLI (op):

bash
brew install zseven-w/openpencil/op

Or use the install script (macOS / Linux):

bash
curl -fsSL https://raw.githubusercontent.com/ZSeven-W/openpencil/main/scripts/install-op.sh | bash

To allow the newest pre-release:

bash
curl -fsSL https://raw.githubusercontent.com/ZSeven-W/openpencil/main/scripts/install-op.sh | OP_PRERELEASE=1 bash

Windows PowerShell:

powershell
irm https://raw.githubusercontent.com/ZSeven-W/openpencil/main/scripts/install-op.ps1 | iex

To allow the newest pre-release:

powershell
$env:OP_PRERELEASE = "1"; irm https://raw.githubusercontent.com/ZSeven-W/openpencil/main/scripts/install-op.ps1 | iex

Cloning (with submodules)

bash
git clone --recurse-submodules https://github.com/ZSeven-W/openpencil.git
# Or already cloned — sync first so stale submodule URLs pick up .gitmodules changes:
git submodule sync --recursive && git submodule update --init --recursive

Three submodules live under vendor/, all public and fetched over HTTPS (no SSH key needed): jian (GPU-Skia UI framework — widgets/render/events), casement (winit fork), and agent (agent-rs — cross-product Rust agent runtime, shared by OP + Zode). vendor/anthropic-agent-sdk is tracked in-tree, not a submodule.

Quick Start (Development)

bash
# Web dev server (builds the CanvasKit wasm bundle, then runs the headless web host)
bash scripts/start-web-rust.sh

Browser-entered built-in provider, image-generation, and Openverse credentials are kept in same-origin localStorage (openpencil-rust-web-credentials) by default, separate from ordinary web preferences. A credential needed by an AI request is sent with that request, but the daemon does not write the browser snapshot to settings.json.

Private deployments can opt into server persistence with OPENPENCIL_PERSIST_WEB_CREDENTIALS_SERVER=true. This setting is deployment-wide; each accepted browser snapshot replaces the shared browser-owned copy. Enable it only for a trusted, access-controlled deployment with one active administrator profile, behind HTTPS. Turning the setting off removes previously persisted browser-owned credentials at the next startup while preserving operator-owned configuration. As with all localStorage, same-origin scripts can read these values, so the web origin must be protected from untrusted scripts and XSS. Before downgrading to a release that predates this switch, turn it off and start the current release once to scrub the browser-owned copy.

The web host supports built-in API-key agents only. CLI and ACP agents remain native-only: they are not shown in the web model picker, stored in browser credential snapshots, synchronized to the server, or exposed through web connect routes. Browser requests to credential and AI endpoints allow loopback/localhost origins by default. A public reverse proxy must separately set OPENPENCIL_WEB_ALLOWED_ORIGINS to a comma-separated list of exact origins, for example https://demo.openpencil.dev.

Server persistence does not permit browser-controlled requests to loopback, private, link-local, metadata, or reserved provider endpoints. A trusted private deployment that intentionally uses an internal provider must separately set OPENPENCIL_WEB_AI_ENDPOINT_ALLOWLIST to a comma-separated list of exact URL origins, for example http://127.0.0.1:11434,https://llm.internal.example.

Or run as a desktop app:

bash
cargo run -p op-host-desktop

Prerequisites: Rust (stable) to build the product. Bun >= 1.0 and Node.js >= 18 are only needed for the web SDK under packages/.

Docker

Tagged Rust releases publish a single web-host image. The retired TypeScript images with bundled AI CLIs are no longer published.

Image	Includes
`ghcr.io/zseven-w/openpencil-web:vX.Y.Z`	Rust web host, wasm bundle, and CanvasKit assets

The web UI exposes built-in agent profiles only; Claude/Codex/OpenCode/Copilot CLI tooling is not bundled into Docker images.

Run:

bash
VERSION="$(scripts/workspace-version.sh)"
docker run -d -p 3100:3100 "ghcr.io/zseven-w/openpencil-web:v${VERSION}"

Then open http://localhost:3100/.

Build locally:

bash
docker build -f Dockerfile.web-rust -t openpencil-web-rust .
docker run -p 3100:3100 openpencil-web-rust

AI-Native Design

Prompt to UI

Text-to-design — describe a page, get it generated on canvas in real-time with SSE streaming animation
Orchestrator — decomposes complex pages into spatial sub-tasks for parallel generation
Agent Teams — concurrent team members with delegate tool, per-member canvas indicators, and fallback strategies
Design modification — select elements, then describe changes in natural language
Vision input — attach screenshots or mockups for reference-based design
Style Guides — apply visual styles (glassmorphism, brutalist, retro, etc.) via tag-based fuzzy matching
Anti-slop — cross-generation diversity tracking to avoid repetitive AI output

Multi-Agent Support

Agent	Setup
Built-in (9+ providers)	Select from provider presets with region switcher — Anthropic, OpenAI, Google, DeepSeek, and more
Claude Code	No config — uses Claude Agent SDK with local OAuth
Codex CLI	Connect in Agent Settings (`Cmd+,`)
OpenCode	Connect in Agent Settings (`Cmd+,`)
GitHub Copilot	`copilot login` then connect in Agent Settings (`Cmd+,`)

Model Capability Profiles — automatically adapts prompts, thinking mode, and timeouts per model tier. Full-tier models (Claude) get complete prompts; standard-tier (GPT-4o, Gemini, DeepSeek) disable thinking; basic-tier (MiniMax, Qwen, Llama, Mistral) get simplified nested-JSON prompts for maximum reliability.

i18n — Full interface localization in 15 languages: English, 简体中文, 繁體中文, 日本語, 한국어, Français, Español, Deutsch, Português, Русский, हिन्दी, Türkçe, ไทย, Tiếng Việt, Bahasa Indonesia.

MCP Server

Built-in MCP server (op-mcp crate) — one-click install into Claude Code / Codex / OpenCode / Kiro / Copilot CLIs
No Node.js required — stdio transport via the desktop binary (--mcp <path>), plus a live HTTP endpoint (127.0.0.1:<port>/mcp) from the running app
Design automation from terminal: read, create, and modify .op files via any MCP-compatible agent
Layered design workflow — design_skeleton → design_content → design_refine for higher-fidelity multi-section designs
Segmented prompt retrieval — load only the design knowledge you need (schema, layout, roles, icons, planning, etc.)
Style guide tools — get_style_guide_tags and get_style_guide for applying visual styles via MCP
Multi-page support — create, rename, reorder, and duplicate pages via MCP tools

Code Generation

React + Tailwind CSS, HTML + CSS, CSS Variables
Vue, Svelte, Flutter, SwiftUI, Jetpack Compose, React Native

CLI — `op`

Install via Homebrew or the install script, then control the design tool from your terminal:

bash
brew install zseven-w/openpencil/op

bash
curl -fsSL https://raw.githubusercontent.com/ZSeven-W/openpencil/main/scripts/install-op.sh | bash

bash
curl -fsSL https://raw.githubusercontent.com/ZSeven-W/openpencil/main/scripts/install-op.sh | OP_PRERELEASE=1 bash

powershell
irm https://raw.githubusercontent.com/ZSeven-W/openpencil/main/scripts/install-op.ps1 | iex

powershell
$env:OP_PRERELEASE = "1"; irm https://raw.githubusercontent.com/ZSeven-W/openpencil/main/scripts/install-op.ps1 | iex

bash
op start                     # Launch desktop app
op start --headless --file design.op # Launch headless file-backed server
op design @landing.txt       # Batch design from file
op design @ui.js             # Sandboxed JavaScript with loops
op insert '{"type":"rectangle"}' # Insert a node
op import:figma design.fig   # Import Figma file
cat design.dsl | op design - # Pipe from stdin

Supports three input methods: inline string, @filepath (read from file), or - (read from stdin). Works with the desktop app, web server, or headless file-backed server. See the CLI command reference for all commands.

LLM Skill — install the OpenPencil Skill plugin to teach AI agents how to design with op. Run op install for detected agents, or target one explicitly with op install --target codex.

Features

Canvas & Drawing

Infinite canvas with pan, zoom, smart alignment guides, and snapping
Rectangle, Ellipse, Line, Polygon, Pen (Bezier), Frame, Text
Boolean operations — union, subtract, intersect with contextual toolbar
Icon picker (Iconify) and image import (PNG/JPEG/SVG/WebP/GIF)
Auto-layout — vertical/horizontal with gap, padding, justify, align
Multi-page documents with tab navigation

Design System

Design variables — color, number, string tokens with $variable references
Multi-theme support — multiple axes, each with variants (Light/Dark, Compact/Comfortable)
Component system — reusable components with instances and overrides
CSS sync — auto-generated custom properties, var(--name) in code output
Reusable UIKits — import/export component kits from .pen files

AI & Agents

Prompt-to-canvas with streaming generation and orchestrator-driven spatial decomposition
Concurrent Agent Teams — multiple designers work on different sections in parallel with per-member canvas indicators
Layered workflow — design_skeleton → design_content → design_refine with focused prompts per phase
Style Guides — 50+ built-in styles (glassmorphism, brutalist, retro, etc.) with tag-based fuzzy matching, wired into planning and generation
Multi-model capability profiles — auto-adapts thinking mode, effort, and prompt shape per model tier
Built-in Rust agent runtime + Anthropic, Claude Agent SDK, OpenCode, Codex, Copilot, Google Gemini API providers
Anthropic-format passthrough for Chinese LLM providers — Kimi, Zhipu, GLM, DouBao, Ark, Bailian/DashScope, ModelScope, Coding Plans

Collaboration

Authenticated peer-to-peer sessions with a public relay fallback and built-in regional collaboration hubs
Join with a 10-character region-tagged pairing code — no account required for LAN sessions
Live remote cursors, cross-account collaboration, and a conflict panel with per-edit detail and replay of discarded edits
Online multi-tenant mode for the --serve-web daemon, authenticated against the op-hub with cross-account tenant sharing
Device login — sign in from the browser through the serve-web daemon, with profile avatars and usernames in the editor

Presentation Decks

Six 16:9 deck templates with a template picker, plus AI deck planning at projector size — one slide per screen
Present a deck as a slideshow with presenter controls
Export a deck as PDF (one page per slide), a self-contained slideshow HTML file, an editable PowerPoint (.pptx), or a hyperframes video composition
Slides rail navigator; the agent validates deck board geometry (aspect, overflow, centering) as well as the prompt

Templates & Web Capture

Scene template center — a browsable catalogue of 58 templates across six scenes, opened from File ▸ New from template
Prompt center with web, dashboard, component, and modify entries and visual prompt previews
Asset center — a full-window responsive gallery with dual-action templates and DESIGN.md style import
Chrome web-capture extension — snapshot any webpage into OpenPencil with faithful HTML / layout capture; snapshots are delivered to your account's inbox on the hub, or downloaded as a ready-to-open .op file offline

Git Integration

Clone wizard with SSH / HTTPS auth and SSH key management
Branch picker — create, switch, delete, merge, all from the git panel
Pull / push cascades with auth retry and non-fast-forward handling
Folder-mode three-way merge with on-disk MERGE_HEAD state tracking
Conflict panel with per-node / per-field three-way cards, inline JSON editor, bulk actions, and inline diff block
Remote settings and SSH keys UI; 15-locale i18n across the whole Git surface

Export

Canvas export — PNG, JPEG, WEBP, PDF (Cmd+Shift+P)
Code export — React + Tailwind, HTML + CSS, Vue, Svelte, Flutter, SwiftUI, Jetpack Compose, React Native
Incremental MCP codegen pipeline — codegen_plan, codegen_submit_chunk, codegen_assemble, codegen_clean

Figma Import

Import .fig files with layout, fills, strokes, effects, text, images, and vectors preserved

Desktop App

Native macOS, Windows, and Linux — a single self-contained binary (winit + GPU Skia, no Electron)
.op file association — double-click to open, single-instance lock
Background update check against GitHub Releases
Native application menu with Save As, Open Recent, and an unsaved-changes dialog on close
Recent files persistence

Tech Stack


Core	Rust workspace (`crates/`) — editor state, widgets, hosts, MCP, AI, codegen
Rendering	GPU Skia everywhere — `skia-safe` (GL) on native, CanvasKit (WASM/WebGL2) in the browser
UI framework	jian — vendored pure-Rust GPU-Skia UI framework: widgets, layout, events, hot reload (`vendor/jian`)
Windowing	winit (vendored `casement` fork)
Desktop	Native binary `openpencil-desktop` — no browser engine
Web SDK	`op-web-sdk` + React 19 / Vue 3 adapters — read-only `.op` viewer (TypeScript)
CLI	`op` — terminal control, batch design DSL
AI	Built-in Rust agent runtime · Anthropic SDK · Claude Agent SDK · OpenCode SDK · Copilot SDK
Lint	clippy · rustfmt (Rust) · oxlint · oxfmt (web SDK)
File format	`.op` — JSON-based, human-readable, Git-friendly

Ecosystem

OpenPencil is part of a family of pure-Rust, AI-native tools from ZSeven-W. They compose: jian renders OpenPencil, agent-rs runs its agents, noema remembers, and zode designs from the terminal.

Project	What it is
DSH OpenPencil	DeepSeek Harness plugin for OpenPencil — exact multi-frame `.op` previews, an interactive canvas, and a managed editor with agent-native design tools, right inside a conversation.
Zode	Open-source, AI-native coding assistant for your terminal — a fast Rust TUI (`ratatui`) that reads your code, runs commands, searches files, and manages git. Drives OpenPencil over MCP.
agent-rs	A pure-Rust async runtime for shipping LLM agents — multi-provider, tool-capable end-to-end, structured permissions, real MCP, zero `unsafe`. Powers OpenPencil's built-in agent runtime (`vendor/agent`) and Zode.
jian	Pure-Rust, GPU-Skia UI framework — widgets, layout, events, and hot reload in one stack. Turns a declarative `.op` document into a native, AI-controllable app with no JS runtime, no DOM, no Electron. OpenPencil's UI framework (`vendor/jian`).
noema	Local-first, non-vector memory system for coding agents. Durable memory as inspectable files, a review queue for new entries, and lexical (embedding-free) recall — works across Zode, Codex, Claude Code, and MCP runtimes.

Why Rust

OpenPencil was rewritten from the ground up in Rust (#129). The rewrite is complete — the TypeScript + Electron editor was retired at v0.7.5, and the Rust workspace in this repo is the product: one native core that is dramatically smaller and faster, and runs on more platforms from a single codebase.

	TypeScript + Electron (retired, `v0.7.5`)	Rust (today)
Desktop runtime	Electron — bundles Chromium + Node.js	Native window (`winit` + GPU Skia), no browser engine
Desktop footprint	Full Chromium runtime per install	Single self-contained binary — 55.5 MB
Web payload	JS + WASM bundle	8.2 MB wasm / 2.18 MB gzip over the wire
Rendering	CanvasKit/Skia on web	One GPU-accelerated Skia backend on every target
Memory	JavaScript GC pauses	No GC — Rust ownership, predictable latency
Codebase	Web stack + Electron	One Rust workspace: editor · CLI · MCP · AI · codegen · Figma · Git
Targets	Web + desktop, two separate stacks	Desktop (macOS/Win/Linux) · mobile (iOS/Android) · browser — one core

Measured improvements

Tiny footprint — the whole desktop app is one 55.5 MB native binary instead of a bundled browser engine plus a Node runtime. The web build is 8.2 MB raw / 2.18 MB gzip after splitting the icon catalog (−48% over the wire).
Scales to large documents — a 10,000-node live canvas (nested auto-layout, four levels deep) writes, reads, and snapshots layout with no panics and ~0% idle CPU; a full layout snapshot of all 10k nodes returns in ~0.68 s.
Fast interaction — pan/zoom no longer re-serializes the document every frame (a single hot-path fix cut wheel-zoom CPU from ~69% to ~0%); drags patch the scene incrementally, text measurement is cached, and repaints coalesce to one per frame.
One core, every screen — the same editor state and the same render backend compile to native desktop, mobile, and the browser via WASM — no parallel reimplementations to keep in sync.
GPU Skia everywhere — native renders through skia-safe on a GL context; the browser renders through CanvasKit on WebGL2 — the same drawing code, the same output.
Native accessibility — AccessKit on macOS, Windows, and Linux, plus a DOM mirror on web, instead of leaning on a browser's a11y tree.
One type-checked workspace — the MCP host, CLI, AI providers, code generation, Figma import, and Git integration all live in a single Rust workspace, with cargo-deny supply-chain gating in CI.

Status: the TypeScript editor was retired at v0.7.5 and lives only in git history; this repository is the Rust workspace. The Rust product is under active development (see the Roadmap below).

Project Structure

1openpencil/
2├── crates/                   Rust workspace — the product
3│   ├── op-editor-core/       Canonical `.op` (PenDocument) editor state + EditorCommand + design variables
4│   ├── op-editor-ui/         Platform-free widgets + RenderBackend facade (wasm32-clean)
5│   ├── op-editor-host-core/  Transport-free host state machines shared by all hosts
6│   ├── op-collab/            Open collaboration wire types, canonical hashes, and exact document apply
7│   ├── op-collab-transport/  Native Noise/TCP transport, bounded admission, and optional LAN discovery
8│   ├── op-collab-smoke/      Two-process authenticated collaboration recovery matrix
9│   ├── op-host-native/       Native host lib — winit + skia-safe GL (desktop + mobile)
10│   ├── op-engine-ffi/        Player C ABI — embed the canvas in iOS / Android shells
11│   ├── op-engine-jni/        Android JNI marshalling layer for op-engine-ffi
12│   ├── op-host-web/          Browser bundle — wasm32 cdylib, CanvasKit renderer
13│   ├── op-host-desktop/      Desktop binary `openpencil-desktop`; also the `--serve-web` daemon
14│   ├── op-host-services/     Headless serve-web / MCP daemon lib
15│   ├── op-host-web-server/   Thin GL-free web-server binary
16│   ├── op-cli/               CLI tool — `op` command
17│   ├── op-mcp/               MCP server — tools, batch design, layered workflow
18│   ├── op-ai/                AI providers, chat runtime, streaming
19│   ├── op-ai-skills/         AI prompt skill engine (phase-driven prompt loading)
20│   ├── op-orchestrator/      Concurrent agent-team orchestration
21│   ├── op-codegen/           Code generators (React, HTML, Vue, Flutter, ...)
22│   ├── op-figma/             Figma .fig file parser and converter
23│   ├── op-git/               Git integration — clone, branch, push/pull, merge
24│   └── ...                   op-opmerge / op-pen-loader / op-design-lint / op-i18n /
25│                             op-config-store / op-process-io / op-acp / op-smoke / ...
26├── packages/                 Web SDK workspace (Bun)
27│   ├── op-web-sdk/           Read-only `.op` web viewer SDK (wraps the wasm bundle)
28│   ├── op-web-sdk-react/     React 19 adapter
29│   └── op-web-sdk-vue/       Vue 3 adapter
30├── vendor/                   Vendored subsystems (git submodules)
31│   ├── jian/                 GPU-Skia UI framework — widgets/render/events
32│   ├── casement/             winit fork
33│   └── agent/                Cross-product Rust agent runtime (agent-rs)
34└── .githooks/                Pre-commit version drift check

Keyboard Shortcuts

Key	Action	Key	Action
`V`	Select	`Cmd+S`	Save
`R`	Rectangle	`Cmd+Z`	Undo
`O`	Ellipse	`Cmd+Shift+Z`	Redo
`L`	Line	`Cmd+C/X/V/D`	Copy/Cut/Paste/Duplicate
`T`	Text	`Cmd+G`	Group
`F`	Frame	`Cmd+Shift+G`	Ungroup
`P`	Pen tool	`Cmd+Shift+P`	Export (PNG/JPG/WEBP/PDF)
`H`	Hand (pan)	`Cmd+Shift+C`	Code panel
`Del`	Delete	`Cmd+Shift+V`	Variables panel
`[ / ]`	Reorder	`Cmd+J`	AI chat
Arrows	Nudge 1px	`Cmd+,`	Agent settings
`Cmd+Alt+U`	Boolean union	`Cmd+Alt+S`	Boolean subtract
`Cmd+Alt+I`	Boolean intersect	`Cmd+Shift+S`	Save As

Scripts

bash
1# Product (Rust — run from the repo root)
2cargo build --workspace              # Build all crates (add --release for prod)
3cargo test --workspace               # Run all tests
4cargo check --workspace              # Type check
5cargo clippy --workspace --all-targets -- -D warnings   # Lint
6cargo fmt --all                      # Format
7bash scripts/start-web-rust.sh       # Web dev server (wasm bundle + headless host)
8cargo run -p op-host-desktop         # Desktop app (binary: openpencil-desktop)
9cargo run -p op-cli -- <args>        # CLI (binary: op)
10
11# Web SDK / JS tooling (run from packages/)
12cd packages && bun run lint          # Lint the web SDK (oxlint); also: bun run format
13cd packages && bun run generate-iconify-catalog   # Regenerate the Rust icon catalog assets
14
15# Version synchronization (run from repository root)
16scripts/sync-version.sh                            # Sync all managed versions from root Cargo.toml
17tools/check-version-sync.sh                        # Verify all managed versions match root Cargo.toml

Rust workspace details

The Rust-ification is complete — the Rust workspace is the product. Kickoff spec: openpencil-docs/superpowers/specs/2026-05-02-rust-ification-kickoff.md (v7 FROZEN).

bash
1# Install Rust toolchain (rust-toolchain.toml auto-pins 1.94)
2rustup toolchain install 1.94
3rustup target add wasm32-unknown-unknown
4
5# build / test / lint
6cargo check --workspace
7cargo test --workspace
8cargo clippy --workspace --all-targets -- -D warnings
9cargo check --target wasm32-unknown-unknown -p op-collab --no-default-features
10cargo check --target wasm32-unknown-unknown -p op-host-web --no-default-features --features web  # kickoff §1.2 wasm32 invariant
11cargo deny check && cargo deny --target wasm32-unknown-unknown check bans        # cargo-deny (native + wasm32 bans; CI uses cargo-deny-action@v2)

Entry crates (crates/ — build targets):

Crate	Category	wasm32
op-host-web	Browser bundle entry — wasm32 cdylib, renders via CanvasKit	✅
op-host-native	Native host lib — WidgetHostNative + skia-safe GL backend (desktop + mobile)	❌ (native only)
op-engine-ffi	Player C ABI — one engine, three shells (iOS Metal / Android EGL / host raster)	❌ (native only)
op-engine-jni	Android JNI marshalling layer for op-engine-ffi (engine thread, registry, callbacks)	❌ (native only)
op-host-desktop	Desktop binary `openpencil-desktop` (winit + skia-safe GL) — also the `--serve-web` daemon that hosts the web bundle	❌ (native only)
op-cli	`op` command-line tool	❌ (native only)

Shared library crates: op-editor-core (canonical .op state), op-editor-ui (platform-free widgets + RenderBackend), op-editor-host-core (transport-free host state machines), op-collab (open, transport-free collaboration protocol/hash/exact apply), op-collab-transport (native Noise/TCP, bounded admission, and optional LAN discovery), op-mcp, op-ai, op-ai-skills, op-codegen, op-orchestrator, op-figma, op-git, op-opmerge, op-pen-loader, op-design-lint, op-config-store, op-process-io, op-acp, op-i18n, op-rpc-transport — plus op-collab-smoke (authenticated two-process collaboration/recovery matrix) and op-smoke (headless design-turn test runner). The mobile players live in packaging/ (ios + android shells over op-engine-ffi / op-engine-jni). The browser bundle renders through the official CanvasKit skia WASM (loaded separately), so the retired skia-safe-op wasm fork + wasm-libc-shim no longer exist.

Submodule: vendor/agent → github.com/ZSeven-W/agent-rs (cross-product Rust agent runtime).

Contributing

Contributions are welcome! See CLAUDE.md for architecture details and code style.

Fork and clone
Enable the version drift check: git config core.hooksPath .githooks
Create a branch: git checkout -b feat/my-feature
Run checks: cargo test --workspace && cargo clippy --workspace --all-targets -- -D warnings
Commit with Conventional Commits: feat(canvas): add rotation snapping
Open a PR against main

Roadmap

Contributors

Community

Join our Discord — Ask questions, share designs, suggest features.

Recognized community: LINUX DO

Forked Third-Party Libraries

We are grateful to the upstream maintainers whose work OpenPencil builds on. These copies are maintained only for OpenPencil-specific integration needs:

casement — forked from winit.
anthropic-agent-sdk — vendored from bartolli/anthropic-agent-sdk and maintained as a local fork.

Each project remains subject to its respective upstream license.

openpencilDeepSeek Harness plugin

Overview

Original README

OpenPencil

Why OpenPencil

OpenPencil × Infistar.cc 无限星河｜全模型 API · 驱动 AI 原生设计创作

🎨 Prompt → Canvas

🤖 Concurrent Agent Teams

🧠 Multi-Model Intelligence

🔌 MCP Server

🎨 Style Guides

📦 Design-as-Code

🖥️ Runs Everywhere

⌨️ CLI — `op`

🎯 Multi-Platform Code Export

🧩 Embeddable SDK

🛡️ Design System Kit

👥 Real-Time Collaboration

Install

Cloning (with submodules)

Quick Start (Development)

Docker

AI-Native Design

CLI — `op`

Features

Tech Stack

Ecosystem

Why Rust

Project Structure

Keyboard Shortcuts

Scripts

Rust workspace details

Contributing

Roadmap

Contributors

Community

Forked Third-Party Libraries

Assessments

License

Overview

Original README

OpenPencil

Why OpenPencil

OpenPencil × Infistar.cc 无限星河｜全模型 API · 驱动 AI 原生设计创作

🎨 Prompt → Canvas

🤖 Concurrent Agent Teams

🧠 Multi-Model Intelligence

🔌 MCP Server

🎨 Style Guides

📦 Design-as-Code

🖥️ Runs Everywhere

⌨️ CLI — op

🎯 Multi-Platform Code Export

🧩 Embeddable SDK

🛡️ Design System Kit

👥 Real-Time Collaboration

Install

Cloning (with submodules)

Quick Start (Development)

Docker

AI-Native Design

CLI — op

Features

Tech Stack

Ecosystem

Why Rust

Project Structure

Keyboard Shortcuts

Scripts

Rust workspace details

Contributing

Roadmap

Contributors

Community

Forked Third-Party Libraries

Assessments

License

⌨️ CLI — `op`

CLI — `op`