ZSeven-W / codex-openpencil

Codex OpenPencil 
 The Codex plugin for OpenPencil — create, inspect, and refine editable .op designs from a conversation. 
 One-Prompt Setup • Interactive Canvas • Selection Prompts • Native Rust Engine 
 English · 简体中文 
 Quick Start · Features · Examples · Ecosystem · Install Guide · Validation 
 Design in a Codex conversation, refine on an editable OpenPencil canvas — MŌDE fashion app home and product detail screens. 
## One-prompt install and first design
> **Image generation is enabled by default.** When a design needs new image assets, Codex uses its built-in image generation, which may consume your Codex image-generation quota. Say **“use stock images only”** to skip generation. Unavailable or failed generation falls back to stock search.
Give Codex this:
 [code] 
INSTALL.md guides Codex through prerequisites, installation, runtime verification, opening the canvas, and completing the first design. Setup downloads the complete Rust editor, matching WASM, CanvasKit, fonts, and templates for your OS and CPU, then verifies a real native edit, save, and reopen before registering the plugin.
You need **Node.js 22+, Git, and a recent local Codex client with plugin support**. No GitHub account, API key, DSH, Rust compiler, separate OpenPencil desktop app, or npm dependency install is needed for this plugin's setup.
Prefer to install manually?
 [code] 
Keep the checkout in a persistent location. Setup registers it as a local marketplace and installs `openpencil@zseven-openpencil`. A newly installed plugin may need reconnecting or a new chat to load its tools; the terminal canvas lets Codex complete the first design in the installation chat.
Setup also verifies the tools through Codex's actual plugin loader. It records your current Node executable privately, so a desktop PATH that differs from your terminal does not prevent startup. Use `npm run host-check` to diagnose plugin loading without opening a chat or editing a design.
| Platform | Runtime builds | System requirements |
| --- | --- | --- |
| macOS | Apple Silicon, Intel | Built on macOS 15 native runners |
| Windows | ARM64, x64 | Matching Microsoft Visual C++ v14 Redistributable |
| Linux | ARM64, x64 | glibc, fontconfig, and FreeType; Ubuntu 24.04+ ARM64 / 22.04+ x64 |
See the full compatibility table and dependency guidance. Fresh installation and native edit/save/reopen checks passed on all six OS/CPU builds; validation records distinguish these checks from bare-OS provisioning and embedded host UI verification.
## Why Codex OpenPencil
Codex OpenPencil connects Codex to the local Rust OpenPencil engine. The result is a real vector document with editable layers, text, shapes, and layout.
### 🎨 Prompt → Canvas
Describe a dashboard, mobile screen, or landing page. Codex creates and refines native design nodes, inspects layout, and renders previews before saving the result.
### ✏️ Interactive Editing
Select layers, pan and zoom, edit text, draw shapes, and undo changes. Mouse edits and Codex