OpenPencil

Alat desain vektor open-source berbasis AI pertama di dunia.
_{Tim Agen Konkuren • Design-as-Code • Server MCP Bawaan • Kecerdasan Multi-model}

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

_{Klik gambar untuk menonton video demo}

`), ditambah endpoint HTTP langsung (`127.0.0.1:/mcp`) dari aplikasi yang berjalan - Otomasi desain dari terminal: baca, buat, dan modifikasi file `.op` melalui agen yang kompatibel dengan MCP - **Alur kerja desain berlapis** — `design_skeleton` → `design_content` → `design_refine` untuk desain multi-bagian dengan fidelitas lebih tinggi - **Pengambilan prompt tersegmentasi** — muat hanya pengetahuan desain yang Anda butuhkan (schema, layout, roles, icons, planning, dll.) - Dukungan multi-halaman — buat, ganti nama, urutkan ulang, dan duplikasi halaman melalui alat MCP **Pembuatan Kode** - React + Tailwind CSS, HTML + CSS, CSS Variables - Vue, Svelte, Flutter, SwiftUI, Jetpack Compose, React Native ## CLI — `op` Instal secara global dan kontrol alat desain dari terminal Anda: ```bash brew install zseven-w/openpencil/op ``` ```bash op start # Jalankan aplikasi desktop op start --headless --file design.op # Jalankan server headless op design @landing.txt # Desain batch dari file op design @ui.js # JavaScript sandbox dengan loop op insert '{"type":"rectangle"}' # Sisipkan sebuah node op import:figma design.fig # Impor file Figma cat design.dsl | op design - # Pipe dari stdin ``` Mendukung string inline, `@filepath`, dan stdin (`-`). Bekerja dengan aplikasi desktop, server web, atau server headless berbasis file. Lihat [referensi perintah CLI](./crates/op-cli/src/usage.txt). **LLM Skill** — instal plugin [OpenPencil Skill](https://github.com/ZSeven-W/openpencil-skill) untuk mengajarkan agen AI mendesain dengan `op`. Jalankan `op install` untuk agen yang terdeteksi atau `op install --target codex` untuk target tertentu. ## Fitur **Kanvas & Menggambar** - Kanvas tak terbatas dengan pan, zoom, panduan perataan cerdas, dan snapping - Persegi panjang, Elips, Garis, Poligon, Pen (Bezier), Frame, Teks - Operasi Boolean — gabungan, kurangi, irisan dengan toolbar kontekstual - Pemilih ikon (Iconify) dan impor gambar (PNG/JPEG/SVG/WebP/GIF) - Auto-layout — vertikal/horizontal dengan gap, padding, justify, align - Dokumen multi-halaman dengan navigasi tab **Sistem Desain** - Variabel desain — token warna, angka, string dengan referensi `$variable` - Dukungan multi-tema — beberapa sumbu, masing-masing dengan varian (Terang/Gelap, Ringkas/Nyaman) - Sistem komponen — komponen yang dapat digunakan ulang dengan instans dan penggantian - Sinkronisasi CSS — properti kustom yang dibuat otomatis, `var(--name)` dalam keluaran kode - UIKit yang dapat digunakan ulang — impor/ekspor kit komponen dari file `.pen` **AI & Agen** - Prompt-ke-kanvas dengan pembuatan streaming dan dekomposisi spasial yang digerakkan orkestrator - Tim Agen Bersamaan — beberapa desainer mengerjakan bagian yang berbeda secara paralel dengan indikator kanvas per anggota - Alur kerja berlapis — `design_skeleton` → `design_content` → `design_refine` dengan prompt yang terfokus per fase - Panduan Gaya — 50+ gaya bawaan (glassmorphism, brutalist, retro, dll.) dengan pencocokan fuzzy berbasis tag, terintegrasi ke perencanaan dan pembuatan - Profil kemampuan multi-model — secara otomatis menyesuaikan mode berpikir, upaya, dan bentuk prompt berdasarkan tingkat model - Runtime agen bawaan (Rust) + penyedia Anthropic, Claude Agent SDK, OpenCode, Codex, Copilot, Gemini - Passthrough format Anthropic untuk penyedia LLM Tiongkok — Kimi, Zhipu, GLM, DouBao, Ark, Bailian/DashScope, ModelScope, Coding Plans **Integrasi Git** - Wizard clone dengan autentikasi SSH / HTTPS dan manajemen kunci SSH - Pemilih branch — buat, beralih, hapus, merge, semua dari panel Git - Kaskade pull / push dengan percobaan ulang autentikasi dan penanganan non-fast-forward - Merge tiga arah mode folder dengan pelacakan status `MERGE_HEAD` di disk - Panel konflik dengan kartu tiga arah per node / field, editor JSON inline, aksi massal, dan blok diff inline - UI pengaturan remote dan kunci SSH; i18n 15 bahasa di seluruh permukaan Git **Ekspor** - Ekspor kanvas — PNG, JPEG, WEBP, PDF (`Cmd+Shift+P`) - Ekspor kode — React + Tailwind, HTML + CSS, Vue, Svelte, Flutter, SwiftUI, Jetpack Compose, React Native - Pipeline codegen MCP inkremental — `codegen_plan`, `codegen_submit_chunk`, `codegen_assemble`, `codegen_clean` **Impor Figma** - Impor file `.fig` dengan tata letak, fill, stroke, efek, teks, gambar, dan vektor tetap terjaga **Aplikasi Desktop** - macOS, Windows, dan Linux native — satu binary mandiri (winit + GPU Skia, tanpa Electron) - Asosiasi file `.op` — klik dua kali untuk membuka, kunci instans tunggal - Pemeriksaan pembaruan latar belakang terhadap GitHub Releases - Menu aplikasi native dengan Simpan sebagai, Buka Terbaru, dan dialog perubahan belum tersimpan saat ditutup - Persistensi file terbaru ## Tumpukan Teknologi | | | | --------------- | -------------------------------------------------------------------------------- | | **Inti** | Workspace Rust (`crates/`) — state editor, widget, host, MCP, AI, codegen | | **Rendering** | GPU Skia di mana saja — `skia-safe` (GL) pada native, CanvasKit (WASM/WebGL2) di browser | | **Framework UI** | jian — framework UI GPU-Skia murni-Rust yang di-vendor: widget, layout, event, hot reload (`vendor/jian`) | | **Windowing** | winit (fork `casement` yang di-vendor) | | **Desktop** | Binary native `openpencil-desktop` — tanpa engine browser | | **Web SDK** | `op-web-sdk` + adapter React 19 / Vue 3 — viewer `.op` baca-saja (TypeScript) | | **CLI** | `op` — kontrol terminal, batch design DSL | | **AI** | Runtime agen Rust bawaan · Anthropic SDK · Claude Agent SDK · OpenCode SDK · Copilot SDK | | **Lint** | clippy · rustfmt (Rust) · oxlint · oxfmt (web SDK) | | **Format file** | `.op` — berbasis JSON, mudah dibaca manusia, ramah Git | ## Ekosistem OpenPencil adalah bagian dari keluarga alat murni-Rust, berbasis AI dari **[ZSeven-W](https://github.com/ZSeven-W)**. Mereka saling melengkapi: `jian` merender OpenPencil, `agent-rs` menjalankan agennya, `noema` mengingat, dan `zode` mendesain dari terminal. | Proyek | Apa itu | | ------ | ------- | | **[Zode](https://github.com/ZSeven-W/zode)** | Asisten koding open-source berbasis AI untuk terminal Anda — TUI Rust yang cepat (`ratatui`) yang membaca kode Anda, menjalankan perintah, mencari file, dan mengelola git. Menggerakkan OpenPencil melalui MCP. | | **[agent-rs](https://github.com/ZSeven-W/agent-rs)** | Runtime async murni-Rust untuk merilis agen LLM — multi-penyedia, mampu memakai alat secara ujung-ke-ujung, izin terstruktur, MCP asli, tanpa `unsafe`. Menggerakkan runtime agen bawaan OpenPencil (`vendor/agent`) dan Zode. | | **[jian](https://github.com/ZSeven-W/jian)** | Framework UI GPU-Skia murni-Rust — widget, layout, event, dan hot reload dalam satu stack. Mengubah dokumen `.op` deklaratif menjadi aplikasi native yang dapat dikendalikan AI tanpa runtime JS, tanpa DOM, tanpa Electron. Framework UI OpenPencil (`vendor/jian`). | | **[noema](https://github.com/ZSeven-W/noema)** | Sistem memori local-first, non-vektor untuk agen koding. Memori tahan lama sebagai file yang dapat diperiksa, antrean tinjauan untuk entri baru, dan pengambilan leksikal (tanpa embedding) — bekerja di seluruh Zode, Codex, Claude Code, dan runtime MCP. | ## Mengapa Rust OpenPencil telah ditulis ulang dari awal dalam **Rust** ([#129](https://github.com/ZSeven-W/openpencil/issues/129)). Penulisan ulang ini telah selesai — editor TypeScript + Electron dipensiunkan pada `v0.7.5`, dan workspace Rust di repo ini adalah produknya: satu inti native yang jauh lebih kecil dan lebih cepat, serta berjalan di lebih banyak platform dari satu basis kode. | | TypeScript + Electron (dipensiunkan, `v0.7.5`) | Rust (saat ini) | | ------------------------- | -------------------------------------------------- | ----------------------------------------------------------------------------- | | **Runtime desktop** | Electron — menyertakan Chromium + Node.js | Jendela native (`winit` + GPU Skia), tanpa engine browser | | **Jejak desktop** | Runtime Chromium penuh per instalasi | Satu binary mandiri — **55.5 MB** | | **Payload web** | Bundle JS + WASM | **8.2 MB** wasm / **2.18 MB** gzip melalui jaringan | | **Rendering** | CanvasKit/Skia di web | Satu backend Skia berakselerasi GPU di **setiap** target | | **Memori** | Jeda JavaScript GC | Tanpa GC — kepemilikan Rust, latensi yang dapat diprediksi | | **Basis kode** | Web stack + Electron | Satu workspace Rust: editor · CLI · MCP · AI · codegen · Figma · Git | | **Target** | Web + desktop, dua stack terpisah | Desktop (macOS/Win/Linux) · mobile (iOS/Android) · browser — satu inti | **Peningkatan terukur** - **Jejak kecil** — seluruh aplikasi desktop adalah satu binary native **55.5 MB** alih-alih engine browser terbundel ditambah runtime Node. Build web berukuran **8.2 MB** mentah / **2.18 MB** gzip setelah pemisahan katalog ikon (−48% melalui jaringan). - **Skalabel untuk dokumen besar** — kanvas live dengan **10,000 node** (auto-layout bertingkat, empat level dalam) menulis, membaca, dan mengambil snapshot layout **tanpa panik dan ~0% CPU idle**; snapshot layout penuh dari semua 10k node dikembalikan dalam **~0.68 dtk**. - **Interaksi cepat** — pan/zoom tidak lagi menyerial ulang dokumen setiap frame (satu perbaikan hot-path memotong CPU wheel-zoom dari **~69% menjadi ~0%**); seret menambal scene secara inkremental, pengukuran teks di-cache, dan repaint digabungkan menjadi satu per frame. - **Satu inti, setiap layar** — state editor yang sama dan backend render yang sama dikompilasi ke desktop native, mobile, dan browser melalui WASM — tanpa reimplementasi paralel yang perlu disinkronkan. - **GPU Skia di mana saja** — native merender melalui `skia-safe` pada konteks GL; browser merender melalui CanvasKit pada WebGL2 — kode gambar yang sama, keluaran yang sama. - **Aksesibilitas native** — AccessKit di macOS, Windows, dan Linux, ditambah mirror DOM di web, alih-alih mengandalkan pohon a11y browser. - **Satu workspace bertipe** — host MCP, CLI, penyedia AI, pembuatan kode, impor Figma, dan integrasi Git semuanya berada dalam satu workspace Rust, dengan penjagaan rantai pasokan `cargo-deny` di CI. > **Status:** editor TypeScript dipensiunkan pada `v0.7.5` dan kini hanya ada dalam riwayat git; repositori ini adalah workspace Rust. Produk Rust sedang dalam pengembangan aktif (lihat Peta Jalan di bawah). ## Struktur Proyek ```text openpencil/ ├── crates/ Workspace Rust — produknya │ ├── op-editor-core/ State editor `.op` (PenDocument) kanonis + EditorCommand + variabel desain │ ├── op-editor-ui/ Widget platform-independen + fasad RenderBackend (wasm32-clean) │ ├── op-editor-host-core/ State machine host tanpa transport, digunakan bersama semua host │ ├── op-host-native/ Lib host native — winit + skia-safe GL (desktop + mobile) │ ├── op-host-web/ Bundle browser — wasm32 cdylib, renderer CanvasKit │ ├── op-host-desktop/ Binary desktop `openpencil-desktop`; juga daemon `--serve-web` │ ├── op-host-services/ Lib daemon serve-web / MCP headless │ ├── op-host-web-server/ Binary web-server ringan tanpa GL │ ├── op-cli/ Alat CLI — perintah `op` │ ├── op-mcp/ Server MCP — alat, batch design, alur kerja berlapis │ ├── op-ai/ Penyedia AI, runtime chat, streaming │ ├── op-ai-skills/ Engine skill prompt AI (pemuatan prompt bertahap) │ ├── op-orchestrator/ Orkestrasi tim agen konkuren │ ├── op-codegen/ Generator kode (React, HTML, Vue, Flutter, ...) │ ├── op-figma/ Parser dan konverter file Figma .fig │ ├── op-git/ Integrasi Git — clone, branch, push/pull, merge │ └── ... op-opmerge / op-pen-loader / op-design-lint / op-i18n / │ op-config-store / op-process-io / op-acp / op-smoke / ... ├── packages/ Workspace Web SDK (Bun) │ ├── op-web-sdk/ SDK viewer web `.op` baca-saja (membungkus bundle wasm) │ ├── op-web-sdk-react/ Adapter React 19 │ └── op-web-sdk-vue/ Adapter Vue 3 ├── vendor/ Subsistem yang di-vendor (git submodules) │ ├── jian/ Framework UI GPU-Skia — widget/render/event │ ├── casement/ Fork winit │ └── agent/ Runtime agen Rust lintas produk (agent-rs) └── .githooks/ Pemeriksaan drift versi pre-commit ``` ## Pintasan Keyboard | Tombol | Aksi | | Tombol | Aksi | | ----------- | ----------------- | --- | ------------- | ---------------------------- | | `V` | Pilih | | `Cmd+S` | Simpan | | `R` | Persegi panjang | | `Cmd+Z` | Batalkan | | `O` | Elips | | `Cmd+Shift+Z` | Ulangi | | `L` | Garis | | `Cmd+C/X/V/D` | Salin/Potong/Tempel/Duplikat | | `T` | Teks | | `Cmd+G` | Grup | | `F` | Frame | | `Cmd+Shift+G` | Pisahkan grup | | `P` | Alat pen | | `Cmd+Shift+P` | Ekspor (PNG/JPG/WEBP/PDF) | | `H` | Hand (pan) | | `Cmd+Shift+C` | Panel kode | | `Del` | Hapus | | `Cmd+Shift+V` | Panel variabel | | `[ / ]` | Ubah urutan | | `Cmd+J` | Chat AI | | Panah | Geser 1px | | `Cmd+,` | Pengaturan agen | | `Cmd+Alt+U` | Union Boolean | | `Cmd+Alt+S` | Subtract Boolean | | `Cmd+Alt+I` | Intersect Boolean | | `Cmd+Shift+S` | Simpan sebagai | ## Skrip ```bash # Product (Rust — run from the repo root) cargo build --workspace # Build all crates (add --release for prod) cargo test --workspace # Run all tests cargo check --workspace # Type check cargo clippy --workspace --all-targets -- -D warnings # Lint cargo fmt --all # Format bash scripts/start-web-rust.sh # Web dev server (wasm bundle + headless host) cargo run -p op-host-desktop # Desktop app (binary: openpencil-desktop) cargo run -p op-cli -- # CLI (binary: op) # Web SDK / JS tooling (run from packages/) cd packages && bun run lint # Lint the web SDK (oxlint); also: bun run format cd packages && bun run generate-iconify-catalog # Regenerate the Rust icon catalog assets # Sinkronisasi versi (jalankan dari root repositori) scripts/sync-version.sh # Sync all managed versions from root Cargo.toml tools/check-version-sync.sh # Verify all managed versions match root Cargo.toml ``` ## Berkontribusi Kontribusi sangat disambut! Lihat [CLAUDE.md](./CLAUDE.md) untuk detail arsitektur dan gaya kode. 1. Fork dan clone 2. Aktifkan pemeriksaan drift versi: `git config core.hooksPath .githooks` 3. Buat cabang: `git checkout -b feat/my-feature` 4. Jalankan pemeriksaan: `cargo test --workspace && cargo clippy --workspace --all-targets -- -D warnings` 5. Commit dengan [Conventional Commits](https://www.conventionalcommits.org/): `feat(canvas): add rotation snapping` 6. Buka PR ke `main` ## Peta Jalan - [x] Variabel & token desain dengan sinkronisasi CSS - [x] Sistem komponen (instans & penggantian) - [x] Pembuatan desain AI dengan orkestrator - [x] Integrasi server MCP dengan alur kerja desain berlapis - [x] Dukungan multi-halaman - [x] Impor Figma `.fig` - [x] Operasi boolean (gabung, kurangi, potong) - [x] Profil kemampuan multi-model - [x] Workspace Cargo dengan crate Rust dan paket SDK web yang dapat digunakan ulang - [x] Editor Rust untuk desktop dan web - [x] Alat CLI (`op`) kontrol terminal - [x] Runtime agen Rust bawaan dengan dukungan multi-penyedia - [x] i18n — 15 bahasa - [x] SDK viewer berbasis wasm untuk JavaScript, React, dan Vue - [x] Style Guides dengan pencocokan berbasis tag dan alat MCP - [x] Agent Teams serentak dengan delegasi dan indikator kanvas - [x] Integrasi Git (clone, branch, push/pull, merge tiga arah mode folder) - [x] Ekspor kanvas (SVG / PNG / JPEG / WEBP / PDF) - [ ] Pengeditan kolaboratif - [ ] Sistem plugin ## Kontributor ## Sponsor OpenPencil gratis dan open source. Pengembangan didanai oleh orang-orang yang merasa terbantu — terima kasih telah menjaga kanvas tetap terbuka. Terima kasih kepada **[MrQyun](https://github.com/mrqyun)** — ingin nama Anda muncul di sini? **[Jadi sponsor →](https://github.com/sponsors/ZSeven-W)** ## Komunitas Bergabung dengan Discord kami — Ajukan pertanyaan, bagikan desain, sarankan fitur. **Komunitas yang diakui: [LINUX DO](https://linux.do/)** ## Star History ## Penilaian [](https://mseep.ai/app/zseven-w-openpencil) ## Lisensi [MIT](./LICENSE) — Copyright (c) 2026 ZSeven-W