Skip to content
Back to search

open-pencil

AI-native design editor. Open-source Figma alternative.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/open-pencil/open-pencil with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/open-pencil/open-pencil'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/open-pencil--open-pencil/badge.svg)](/listings/open-pencil--open-pencil)

HTML

<a href="/listings/open-pencil--open-pencil"><img src="/api/listings/open-pencil--open-pencil/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**macOS (Homebrew):**

brew install --cask openpencil

Or download from the [releases page](https://github.com/open-pencil/open-pencil/releases/latest), or [use the web app](https://app.openpencil.dev) — no install needed.

Requires macOS 13 or later with current Safari updates, Windows 10 or later, or Linux with WebKitGTK 2.40+; the web app needs Chrome 111, Edge 111, Firefox 128, or Safari 16.4 or later. See [system requirements](https://openpencil.dev/getting-started#system-requirements).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 254 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # OpenPencil
  2. [![MIT license](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
  3. [![npm](https://img.shields.io/npm/v/@open-pencil/cli?label=%40open-pencil%2Fcli)](https://www.npmjs.com/package/@open-pencil/cli)
  4. [![Discord](https://img.shields.io/badge/Discord-join-5865F2?logo=discord&logoColor=white)](https://discord.gg/4wXc9fuZfm)
  5. [![GitHub Discussions](https://img.shields.io/github/discussions/open-pencil/open-pencil?logo=github&label=Discussions)](https://github.com/open-pencil/open-pencil/discussions)
  6. [![Ko-fi](https://img.shields.io/badge/Ko--fi-support-FF5E5B?logo=ko-fi&logoColor=white)](https://ko-fi.com/dannote)
  7. Open-source design editor. Opens `.fig` and `.pen` design files, includes built-in AI, and ships as a programmable toolkit with a headless Vue SDK for building custom editors.
  8. > **Status:** Active development. Usable today, with some rough edges as features evolve.
  9. **[Try it online →](https://app.openpencil.dev/demo)** · [Download](https://github.com/open-pencil/open-pencil/releases/latest) · [Documentation](https://openpencil.dev) · [Roadmap](https://openpencil.dev/development/roadmap) · [llms.txt](https://openpencil.dev/llms.txt)
  10. ![OpenPencil](packages/docs/public/screenshot.png)
  11. ## Installation
  12. **macOS (Homebrew):**
  13. ```sh
  14. brew install --cask openpencil
  15. ```
  16. Or download from the [releases page](https://github.com/open-pencil/open-pencil/releases/latest), or [use the web app](https://app.openpencil.dev) — no install needed.
  17. Requires macOS 13 or later with current Safari updates, Windows 10 or later, or Linux with WebKitGTK 2.40+; the web app needs Chrome 111, Edge 111, Firefox 128, or Safari 16.4 or later. See [system requirements](https://openpencil.dev/getting-started#system-requirements).
  18. Official builds send one anonymous ping a day and share usage stats only if you agree. The [privacy page](https://openpencil.dev/overview/privacy) lists every field, everything else the app sends, and how to turn it off.
  19. ## What it does
  20. - **Opens `.fig` and `.pen` files** — read and write native Figma files, open supported Pencil documents from the app or OS file browser, copy & paste nodes between apps
  21. - **AI builds designs** — describe what you want in chat, 100+ tools create and modify nodes. Bring your own key for the major providers or any compatible endpoint
  22. - **Fully programmable** — headless CLI, XPath queries, Figma Plugin API plus an `openpencil` API via `eval`, MCP server for AI agents, and desktop agent integrations for Claude Code, Codex, Antigravity CLI, Gemini CLI, Cursor, Grok Build, and Pi
  23. - **Lint, convert, and extract tokens** — inspect documents, lint naming/layout/accessibility, convert between supported formats, analyze colors/typography/spacing/clusters, and extract design tokens
  24. - **Components and variants** — create reusable components, group variants into component sets, insert local assets as instances, and switch variants from the inspector
  25. - **Working controls** — give a component a Reka UI behaviour (switch, slider, tabs, text field, …) and preview it live over the canvas, with real inputs, focus, and keyboard
  26. - **Image vectorization** — convert image layers into editable vector layers with Recraft or fal.ai
  27. - **Design-to-code export** — export selections as JSX/Tailwind, generate token outputs, and map designs into component-oriented code workflows
  28. - **Vue SDK for custom editors** — headless components and composables for embedding OpenPencil into other apps or building workflow-specific editing surfaces. [Read the SDK docs →](https://openpencil.dev/programmable/sdk/)
  29. - **Real-time collaboration** — share a peer-to-peer room over WebRTC with no server or account, or edit Cloud documents together. Cursors, presence, follow mode, voice calls
  30. - **Optional Cloud** — keep documents on your team's own [OpenPencil Cloud](https://openpencil.dev/cloud/) server, or on the hosted service once it opens, and share them by invitation
  31. - **Auto layout & CSS Grid** — flex and grid layout via Taffy WASM, with gap, padding, alignment, track sizing
  32. - **~15 MB desktop app** — Tauri v2 for macOS, Windows, Linux. Also runs in the browser as a PWA
  33. ## CLI
  34. ```sh
  35. npm install -g @open-pencil/cli
  36. # or: bun add -g @open-pencil/cli
  37. ```
  38. ### Inspect design files
  39. Browse node trees, search by name or type, dig into properties — all without opening the editor:
  40. ```sh
  41. openpencil tree design.fig
  42. openpencil find design.pen --type TEXT
  43. openpencil node design.fig --id 1:23
  44. openpencil info design.fig
  45. ```
  46. ```
  47. [0] [page] "Getting started" (0:46566)
  48. [0] [section] "" (0:46567)
  49. [0] [frame] "Body" (0:46568)
  50. [0] [frame] "Introduction" (0:46569)
  51. [0] [frame] "Introduction Card" (0:46570)
  52. [0] [frame] "Guidance" (0:46571)
  53. ```
  54. ### Query with XPath
  55. Find nodes by type, attributes, and structure:
  56. ```sh
  57. openpencil query design.fig "//FRAME[@width < 300]" # Frames under 300px
  58. openpencil query design.fig "//SECTION//TEXT" # Text inside sections
  59. ```
  60. ### Export, convert, and import
  61. Render to PNG, JPG, WEBP, SVG, PDF, PPTX, HTML, JSX, Storybook stories, or `.fig`, convert between document formats, and turn HTML/CSS into editable layers:
  62. ```sh
  63. openpencil export design.fig # PNG
  64. openpencil export design.fig -f jpg -s 2 # JPG at 2x
  65. openpencil export design.fig -f tailwind-jsx # Tailwind JSX
  66. openpencil export design.fig -f storybook # Storybook stories per component
  67. openpencil convert design.pen design.fig # Between document formats
  68. openpencil import card.html --css card.css # HTML/CSS → editable .fig
  69. ```
  70. ### Lint and analyze
  71. Catch naming, layout, and accessibility issues, and audit a design system's real palette, type scale, spacing, and repeated components:
  72. ```sh
  73. openpencil lint design.fig --preset strict # Naming, layout, accessibility
  74. openpencil analyze colors design.fig # Also typography, spacing, clusters
  75. openpencil variables design.fig # Variables and collections
  76. ```
  77. ```
  78. #1d1b20 ██████████████████████████████ 17155×
  79. #49454f ██████████████████████████████ 9814×
  80. #ffffff ██████████████████████████████ 8620×
  81. #6750a4 ██████████████████████████████ 3967×
  82. ```
  83. ### Script with the Figma Plugin API
  84. `eval` runs JavaScript against the document with Figma's Plugin API; `-w` writes the result back:
  85. ```sh
  86. openpencil eval design.fig -c "figma.currentPage.selection.forEach(n => n.opacity = 0.5)" -w
  87. ```
  88. ### Control the running app
  89. Omit the file argument and the CLI works on the document open in the editor:
  90. ```sh
  91. openpencil tree # Inspect the live document
  92. openpencil documents list # Also open, new, save, close, activate
  93. openpencil tool call get_selection # Run any MCP tool
  94. openpencil undo # Undo the newest automation change
  95. openpencil settings set appearance.theme light # Change editor settings
  96. ```
  97. Every command supports `--json`. See the [CLI reference](https://openpencil.dev/reference/cli) for all commands and options.
  98. ## AI & MCP
  99. ### Built-in chat
  100. Press <kbd>⌘</kbd><kbd>J</kbd> (<kbd>Ctrl</kbd><kbd>J</kbd> on Windows and Linux) to open the AI assistant. It has 100+ tools that can create shapes, set fills and strokes, manage auto-layout, work with components and variables, run boolean operations, analyze design tokens, and export assets. Bring your own API key for OpenRouter, Anthropic, OpenAI, Google AI, DeepSeek, Z.ai, MiniMax, or compatible endpoints. No backend, no account.
  101. Not every provider works in the browser, and not every model streams tool calls correctly. See [BYOK provider & model compatibility](https://openpencil.dev/programmable/byok-provider-compatibility) for measured results — contributions welcome.
  102. ### Coding agents (desktop)
  103. Use Claude Code, Codex, Gemini CLI, or Pi as the design agent in the chat panel. It runs with your own subscription and reaches the canvas through the editor's MCP server. Requires the desktop app.
  104. Install the agent's ACP program and `@open-pencil/mcp`, then open **Settings → Models → Run guided setup**. It checks that both are installed, signs the agent in, and confirms a session reaches OpenPencil's tools. Pi runs through the `@open-pencil/harness` companion, which guided setup installs with one click. See [Coding agents](https://openpencil.dev/programmable/coding-agents) for each agent's install command.
  105. ### MCP server
  106. Connect Claude Code, Cursor, Windsurf, or any MCP client to inspect, modify, and export design documents headlessly. [Full docs →](https://openpencil.dev/programmable/mcp-server)
  107. **Stdio** (Claude Code, Cursor, Windsurf):
  108. ```sh
  109. npm install -g @open-pencil/mcp
  110. claude mcp add --scope user open-pencil -- openpencil-mcp
  111. ```
  112. For other MCP clients:
  113. ```json
  114. {
  115. "mcpServers": {
  116. "open-pencil": {
  117. "command": "openpencil-mcp"
  118. }
  119. }
  120. }
  121. ```
  122. **HTTP** (scripts, CI):
  123. ```sh
  124. openpencil-mcp-http # Unix socket on macOS/Linux + http://127.0.0.1:7600/mcp
  125. ```
  126. Set `OPENPENCIL_MCP_ROOT` to limit file access to one directory; it defaults to the current working directory.
  127. ### [AI agent skill](skills/open-pencil/SKILL.md)
  128. Teach your AI coding agent to use OpenPencil — inspect designs, export assets, analyze tokens, modify .fig files:
  129. ```sh
  130. npx skills add open-pencil/open-pencil
  131. ```
  132. Works with Claude Code, Cursor, Windsurf, Codex, and any agent that supports [skills](https://skills.sh).
  133. For documentation-aware agents, the docs site publishes [llms.txt](https://openpencil.dev/llms.txt), [llms-full.txt](https://openpencil.dev/llms-full.txt), and per-page Markdown files generated from the VitePress docs.
  134. ## Collaboration
  135. Share a link to co-edit in real time. No server, no account — peers connect directly via WebRTC.
  136. 1. Click the share button in the top-right panel
  137. 2. Share the generated link (`app.openpencil.dev/rooms/<room-id>`)
  138. 3. Collaborators see your cursor, selection, and edits in real time
  139. 4. Click a peer's avatar to follow their viewport
  140. 5. Click the headphones beside the avatars to start or join the room's voice call
  141. ## Why
  142. Figma is a closed platform that resists programmatic access: its MCP server is read-only, and automation outside the Plugin API breaks when it ships a point release. Your design files are in a proprietary binary format that only its software can fully read.
  143. OpenPencil is the alternative: open source (MIT), local-first, reads .fig files natively, and every operation is scriptable.
  144. See the [roadmap](https://openpencil.dev/development/roadmap) for product direction and current Figma compatibility gaps.
  145. ## Community
  146. - **[Discord](https://discord.gg/4wXc9fuZfm)** — chat, quick questions, and showing a problem live
  147. - **[GitHub Discussions](https://github.com/open-pencil/open-pencil/discussions)** — [Q&A](https://github.com/open-pencil/open-pencil/discussions/categories/q-a) for help, [Ideas](https://github.com/open-pencil/open-pencil/discussions/categories/ideas) for feature proposals, [Show and tell](https://github.com/open-pencil/open-pencil/discussions/categories/show-and-tell) for what you built; maintainers post [Announcements](https://github.com/open-pencil/open-pencil/discussions/categories/announcements) there
  148. - **[Issues](https://github.com/open-pencil/open-pencil/issues)** — reproducible bugs; report security problems through a [private advisory](https://github.com/open-pencil/open-pencil/security/advisories/new)
  149. ## Support
  150. OpenPencil is free and open source. Donations help speed up its development and cover the servers and services it runs on. You can [donate on Ko-fi](https://ko-fi.com/dannote).
  151. ## Contributing
  152. ```sh
  153. bun install
  154. bun run dev:portless # Web editor at https://open-pencil.localhost
  155. bun run tauri dev # Desktop app (requires Rust)
  156. ```
  157. [CONTRIBUTING.md](CONTRIBUTING.md) covers setup, quality gates, pull requests, and commits. [AGENTS.md](AGENTS.md) maps the repository and links the guide inside each package. Desktop builds need [Rust](https://rustup.rs/) and the [Tauri v2 prerequisites](https://v2.tauri.app/start/prerequisites/); run `bun run tauri build`.
  158. ### Tech stack
  159. | Layer | Tech |
  160. | ------------- | --------------------------------------------------------------------------------- |
  161. | Rendering | Skia (CanvasKit WASM) |
  162. | Layout | [Taffy](https://github.com/DioxusLabs/taffy) WASM (flex + grid) |
  163. | UI | Vue 3, Reka UI, Tailwind CSS 4 |
  164. | File format | Kiwi binary + Zstd + ZIP |
  165. | Collaboration | Trystero (WebRTC P2P) + Yjs (CRDT) |
  166. | Desktop | Tauri v2 |
  167. | AI/MCP | Vercel AI SDK (multi-provider BYOK), MCP SDK, Hono |
  168. ## Acknowledgments
  169. Thanks to [@sld0Ant](https://github.com/sld0Ant) (Anton Soldatov), who pushed for OpenPencil to be published, has backed and promoted it since, and built the first version of the [documentation site](https://openpencil.dev).
  170. Thanks to everyone who has [contributed](https://github.com/open-pencil/open-pencil/graphs/contributors) code, translations, bug reports, and feedback.
  171. Thanks to [Anthropic](https://www.anthropic.com) for supporting the project through its open source program, and to [CodeRabbit](https://www.coderabbit.ai) for reviewing every pull request for free.
  172. ## License
  173. OpenPencil is licensed under the [MIT License](./LICENSE), except OpenPencil Cloud, which is licensed under the [Apache License 2.0](./LICENSES/Apache-2.0.txt). [`REUSE.toml`](./REUSE.toml) lists the exact paths.
  174. Copyright (c) 2026 Danila Poyarkov and OpenPencil contributors.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.