opencodekit 0.19.3 → 0.19.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,3 @@
1
+ {
2
+ "enabled": true
3
+ }
@@ -12,7 +12,7 @@
12
12
  },
13
13
  "dependencies": {
14
14
  "@google/stitch-sdk": "^0.0.3",
15
- "@opencode-ai/plugin": "1.3.9"
15
+ "@opencode-ai/plugin": "1.3.13"
16
16
  },
17
17
  "devDependencies": {
18
18
  "@types/node": "^25.3.0",
@@ -1,68 +1,72 @@
1
1
  ---
2
2
  name: pencil
3
- description: Pencil design-as-code workflow (CLI + MCP). Create/edit .pen files and export visuals.
3
+ description: OpenPencil design-as-code workflow (legacy skill name: pencil). Create/edit .op files, export code, and use desktop-bundled MCP.
4
4
  version: 1.0.0
5
- tags: [design, pencil, mcp, cli]
5
+ tags: [design, openpencil, mcp, cli]
6
6
  mcp:
7
7
  pencil:
8
- command: /Applications/Pencil.app/Contents/Resources/app.asar.unpacked/out/mcp-server-darwin-arm64
9
- args: ["--app", "desktop"]
8
+ command: openpencil-mcp
10
9
  ---
11
10
 
12
- # Pencil Skill
11
+ # OpenPencil Skill
12
+
13
+ Legacy skill name: `pencil`.
13
14
 
14
15
  ## When to Use
15
16
 
16
- - Create or modify UI designs as code using `.pen` files.
17
- - Export PNG/JPEG/WEBP/PDF for review or handoff.
18
- - Run headless, scriptable design changes via CLI/MCP tools.
17
+ - Create or modify UI designs as code using `.op` files.
18
+ - Export production code or visuals from the terminal.
19
+ - Use OpenPencil's desktop-bundled MCP server after installing the app.
19
20
 
20
21
  ## Prerequisites
21
22
 
22
23
  ### Install CLI
23
24
 
24
25
  ```bash
25
- npm install -g @pencil.dev/cli
26
- pencil version
26
+ npm install -g @zseven-w/openpencil
27
+ op status
27
28
  ```
28
29
 
29
- ### Authenticate
30
+ ### Install Desktop App for MCP
30
31
 
31
- ```bash
32
- pencil login
33
- ```
32
+ - Install the OpenPencil desktop app from the ZSeven-W/openpencil releases page.
33
+ - Open **Agent Settings** inside OpenPencil and use the one-click MCP install for OpenCode/Claude Code/Codex/etc.
34
+ - The npm CLI install does **not** provide `openpencil-mcp`; that binary is bundled with the desktop app.
34
35
 
35
36
  ### MCP Server
36
37
 
37
- - Starts automatically when Pencil runs (extension or desktop).
38
- - Verify in Cursor: Settings Tools & MCP.
39
- - In Codex CLI: run Pencil first, then `/mcp`.
38
+ - OpenPencil ships a built-in MCP server for agent tooling.
39
+ - The server command is `openpencil-mcp` once the desktop app has installed/exposed it.
40
+ - Keep MCP disabled in template config until OpenPencil desktop is installed locally.
40
41
 
41
42
  ## Quick Start
42
43
 
43
44
  ```bash
44
45
  # Create new design
45
- pencil --out design.pen --prompt "Create a login page with email, password, CTA"
46
+ op design @landing.txt
46
47
 
47
- # Modify existing design
48
- pencil --in design.pen --out design-v2.pen --prompt "Add a sidebar nav"
48
+ # Start the desktop app
49
+ op start
49
50
 
50
- # Export to image
51
- pencil --in design.pen --export design.png --export-scale 2
51
+ # Export code
52
+ op export react --out .
52
53
 
53
- # Interactive MCP shell
54
- pencil interactive -o design.pen
54
+ # Import a Figma file
55
+ op import:figma design.fig
55
56
  ```
56
57
 
57
- ## Core MCP Tools (examples)
58
+ ## Core CLI Commands
58
59
 
59
- - `get_editor_state({ include_schema: true })`
60
- - `get_guidelines()`
61
- - `batch_design({ operations: "..." })`
62
- - `get_screenshot({ nodeId: "..." })`
63
- - `export_nodes({ nodeIds: ["..."], format: "png" })`
60
+ - `op design @brief.txt`
61
+ - `op design:skeleton`
62
+ - `op design:content`
63
+ - `op design:refine --root-id <id>`
64
+ - `op export react --out .`
65
+ - `op import:figma design.fig`
64
66
 
65
67
  ## Notes
66
68
 
67
- - Pencil uses `.pen` files as the source of truth.
68
- - Use taste-skill for design quality, Pencil for execution.
69
+ - OpenPencil uses `.op` files as the source of truth.
70
+ - CLI install is published on npm as `@zseven-w/openpencil` and exposes the `op` binary.
71
+ - MCP is a desktop-app-bundled feature, not a standalone npm package.
72
+ - Use taste-skill for design quality, OpenPencil for execution.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "opencodekit",
3
- "version": "0.19.3",
3
+ "version": "0.19.5",
4
4
  "description": "CLI tool for bootstrapping and managing OpenCodeKit projects",
5
5
  "keywords": [
6
6
  "agents",