# OpenPencil

An open-source design editor for .fig and .pen files, components, auto layout, exports, AI design tools and programmable workflows.

> This is the Markdown version of the OpenPencil page on OpenNavo, with the same facts as the web page: <https://opennavo.com/apps/openpencil>

- **Latest version**: `0.16.0`
- **Developer**: Danila Poyarkov and OpenPencil contributors
- **Homepage**: <https://openpencil.dev/>
- **Categories**: [Design](https://opennavo.com/categories/design)
- **Install**: `brew install --cask openpencil`
- **30-day installs**: 600
- **Homebrew**: Available; the app updates itself
- **Download URL**: <https://github.com/open-pencil/open-pencil/releases/download/v0.16.0/OpenPencil_aarch64.app.tar.gz>
- **SHA-256**: `31d3fc5bdde7acffa506e063263d2a1bcb913f405ddef47d405742514ee65527`

SHA-256 only checks that the download is complete; it is not a security certification.

## Installation and removal contents

```json
[
  {
    "declaration": {
      "app": [
        "OpenPencil.app"
      ],
      "target": "/Applications/OpenPencil.app"
    },
    "phase": "install",
    "sources": [
      "OpenPencil.app"
    ],
    "target": "/Applications/OpenPencil.app",
    "type": "app"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "~/Library/Application Support/net.dannote.open-pencil",
            "~/Library/Caches/net.dannote.open-pencil",
            "~/Library/Preferences/net.dannote.open-pencil.plist",
            "~/Library/Saved Application State/net.dannote.open-pencil.savedState"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## About

OpenPencil is a design editor for designers, design-system maintainers and developers who want to work with Figma .fig and supported Pencil .pen documents through both a visual canvas and programmable tools. It provides layers, vector editing, components/variants, variable bindings, typography, flex/grid layouts, guides and multiple document tabs. CLI, Figma Plugin API-compatible scripting and MCP workflows can inspect files, edit designs, export assets and extract design tokens.

### Editing, imports and exports
Open existing design files or create documents, edit reusable components and inspect spacing, layout and paint properties. Supported exports include raster images, SVG, PDF, editable PowerPoint and HTML/JSX workflows; complex PowerPoint layers may be embedded as images instead of becoming editable shapes. HTML/CSS/Tailwind imports and Figma round trips have compatibility limits. The project describes itself as actively developed with rough edges: preserve original files and test fonts, colors, effects, variables and component links after conversion. Missing/substituted fonts can change results; the app and CLI expose font-fidelity information and policies.

### Installation and hardware
The current catalog version is 0.16.0. Its official Apple-silicon app archive OpenPencil_aarch64.app.tar.gz is 16,417,594 bytes in the GitHub release metadata; the DMG is a separate artifact. Version 0.16.0 explicitly requires macOS 13 or later. The earlier 0.15.1 bundle declaration of 10.13 does not describe current support and never meant Apple silicon could run that OS. No fixed RAM minimum was established. Large documents and AI integrations need additional resources.

### Version 0.16 compatibility and privacy
Upgrade openpencil-mcp with the app. Shared rooms use a new format and cannot mix old and new clients; saved old rooms convert on reopening. SDK, JSX, gradients, variable bindings, tokens and scene-graph APIs have breaking changes: read the exact migration notes before updating custom integrations. Official builds send a daily anonymous request without an identifier, containing version, OS, architecture, desktop/web and usage-sharing state. Disable it in Privacy settings or on desktop with OPENPENCIL_TELEMETRY=0 or DO_NOT_TRACK=1. Broader usage statistics require separate consent; local storage does not imply no network activity.

The publisher also offers Intel Mac, Windows and Linux builds and a browser editor requiring no desktop installation. Use the artifact matching your CPU. Place the extracted Mac app in Applications and follow normal macOS signing/security prompts. The official Homebrew command is `brew install --cask openpencil`; do not confuse it with the retired tap or assume the cask has every GitHub release immediately. This listing performs no installation.

The desktop app does not require Node/Bun/Rust/Xcode for ordinary editing. Those are source-build or optional tooling requirements. Install the CLI or MCP packages separately if needed; the desktop cask does not supply the CLI. Desktop coding-agent integrations require their own agent CLI/authentication, and Pi's companion harness is separately installed. Online fonts, external media and document-specific assets can require network access.

### License, fees and accounts
OpenPencil is MIT-licensed, copyright Danila Poyarkov and contributors. Ordinary editor use has no OpenPencil subscription or required OpenPencil account. Optional AI uses your selected provider's key/account and billing; image vectorization and external agents/services have their own terms and charges. The software license does not grant rights to imported designs, fonts or stock images. Check those licenses before sharing or exporting.

### AI, automation and permissions
Configure models for Design, Review, Fast and Vision roles; providers include direct or compatible endpoints. Official AI documentation says keys communicate directly with the configured provider rather than an OpenPencil model backend. Requests may include prompts, selected design context and image attachments. Review provider retention and cost policies before sending private designs. Browser provider compatibility depends on CORS and tool-call streaming.

Tool access independently controls built-in AI and local MCP tools, with read-only/side-effect groups. These switches are not a sandbox: an enabled eval/script tool can perform operations whose dedicated tools are disabled. WebMCP Off/Inspect/Edit, remote MCP permissions and agent shell/filesystem permissions are separate controls. Limit OPENPENCIL_MCP_ROOT for file operations and trust remote servers before giving them bearer credentials. The desktop can request file access and system credential-store access; 0.15.1 defers provider connections and credential reads until a connected feature is used.

### Storage, network and privacy
Saved chat history, attachment previews, preferences and recovery snapshots are local. Desktop credentials use the system credential store; the documented browser option uses encrypted storage or session-only credentials. This does not make a compromised device/browser safe. Configured S3-compatible storage, AI providers, remote MCP endpoints, fonts and collaboration can send data outside the device. A local document is not automatically an offline-only workflow.

Official collaboration documentation describes direct WebRTC peer editing without an OpenPencil account or central document relay. Anyone with the room link can join and receive document edits, cursors and selections, so share links only with intended collaborators. AI/provider services and storage have separate trust boundaries. Local diagnostics include token/provider/model usage and failure records with retention, export and clear controls; 0.15.1 adds conversation/request identifiers and removes transcript content from the separate chat diagnostic flow. Inspect diagnostic exports before sharing.

Keep backups before agent edits or format conversions, inspect generated code and exported documents, and review cloud storage permissions. Local chat history/recovery is not a substitute for a separate backup, and external agent sessions may not resume simply because a transcript is retained.

Sources: [Official project and downloads](https://github.com/open-pencil/open-pencil), [Getting started](https://openpencil.dev/getting-started), [AI chat/tool permissions](https://openpencil.dev/programmable/ai-chat), [Collaboration](https://openpencil.dev/programmable/collaboration), [MIT license](https://github.com/open-pencil/open-pencil/blob/v0.15.1/LICENSE), [Exact 0.15.1 release](https://github.com/open-pencil/open-pencil/releases/tag/v0.15.1).

[0.16 migration and security](https://github.com/open-pencil/open-pencil/releases/tag/v0.16.0) · [Privacy](https://openpencil.dev/overview/privacy)

## System requirements

- macOS 13 or later · Version: 0.16.0 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/openpencil.rb> · Checked 2026-11-22
  - <https://github.com/open-pencil/open-pencil/releases/download/v0.16.0/OpenPencil_x64.app.tar.gz>
  - SHA-256: `39ae0083ed6840e80533d4b08187d06fc40e474a2ded35a901d7548c4b5cf6ed`
- macOS 13 or later · Version: 0.16.0 · Apple silicon · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/openpencil.rb> · Checked 2026-11-22
  - <https://github.com/open-pencil/open-pencil/releases/download/v0.16.0/OpenPencil_aarch64.app.tar.gz>
  - SHA-256: `31d3fc5bdde7acffa506e063263d2a1bcb913f405ddef47d405742514ee65527`

## OpenPencil security facts

Only facts that can be checked, each with its source and date. This is not a safety certification. To check the files you downloaded, scan them on your Mac with OpenNavo.

- <https://github.com/open-pencil/open-pencil> · Open source: Yes — <https://github.com/open-pencil/open-pencil> · Checked 2026-11-13

## Uninstall

- `brew uninstall --cask openpencil`

A regular uninstall removes the app and keeps its settings and caches.

### Deep clean (optional)

- `brew uninstall --zap --cask openpencil`

`--zap` also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out `--zap`.

A regular uninstall removes the app and keeps its settings and caches.

- Files and folders: `~/Library/Application Support/net.dannote.open-pencil` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/openpencil.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Caches/net.dannote.open-pencil` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/openpencil.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Preferences/net.dannote.open-pencil.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/openpencil.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Saved Application State/net.dannote.open-pencil.savedState` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/openpencil.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.

## Latest release notes

### 0.17.0-beta.7 (2026-11-21)

This is a pre-release that lists changes since 0.17.0-beta.6: npm packages are published under the `next` tag, and installed apps on the stable release do not update to it. Linux package managers see `0.17.0-beta.7` as newer than `0.17.0`, so `.deb` and `.rpm` users should remove the beta before installing the final 0.17.0.

##### Breaking changes

- The editor's design tokens moved from `@open-pencil/vue/theme/tokens.css` to `@open-pencil/theme/tokens.css`, a package of their own, since the headless Vue SDK never used them (#2243).

##### Added

- Opening a URL on desktop first renders the page with its scripts in a hidden private window and opens what they built once the page settles, so a page that builds itself with JavaScript, such as a single-page app, usually opens with its content instead of empty; a page that cannot be rendered opens from the HTML its server sends (#2238).
- Image fills and strokes draw their exposure, contrast, saturation, temperature, tint, highlights, and shadows adjustments on the canvas and in exports, matching Figma's output, and the image fill picker sets them with sliders, as Figma's does (#2241).
- `@open-pencil/theme` publishes the editor's design tokens and its button, alert, input, link, focus ring, settings layout, and Cloud portal frame as tailwind-variants configurations, with no framework, so a page beside Cloud, such as its billing pages, can look like the editor (#2243).

##### Fixed

- Exports, previews, the eyedropper, and closing a canvas free the image memory and fonts they used instead of keeping them (#2232).
- An image fill or stroke keeps Figma's adjustments, such as exposure, contrast, and saturation, when it is edited and the `.fig` file is saved, instead of losing them (#2233).
- Deeply nested layers keep their names readable: the layers panel scrolls sideways to the selected layer, as in Figma (#2246).
- Opening billing from Cloud's plan page signs in, instead of being refused, because Cloud's pages now name their origin to other sites (#2249).

## Facts and sources

- <https://opennavo.com/apps/openpencil>
- <https://opennavo.com/apps/openpencil/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/openpencil.rb> · Checked 2026-11-22
- <https://formulae.brew.sh/cask/openpencil>
- <https://github.com/open-pencil/open-pencil> · Checked 2026-11-13
