openpencil/packages/docs/programmable/ai-chat.md
Danila Poyarkov a4b810620f Add Programmable docs section with CLI, JSX, MCP, AI, Collab
New top-level nav section documenting OpenPencil's programmability:
- CLI: inspecting, exporting, analyzing, scripting (eval)
- JSX Renderer: elements, style props, visual diffing
- MCP Server: moved from Reference (setup + tool list)
- AI Chat: setup, 87 tools, example prompts
- Collaboration: room sharing, cursors, follow mode

Restructured sidebar:
- Programmable added to nav bar (7 locales)
- Context Menu moved from User Guide to Reference
- MCP and eval-command removed from Reference
2026-03-08 13:22:36 +03:00

1.9 KiB

title description
AI Chat Built-in AI assistant with 87 tools for creating and modifying designs.

AI Chat

Press ⌘J (Ctrl + J) to open the AI assistant. Describe what you want — it creates shapes, sets styles, manages layout, works with components, and analyzes your design.

Setup

  1. Open the AI chat panel (⌘J)
  2. Click the settings icon
  3. Enter your OpenRouter API key
  4. Choose a model (Claude, GPT-4, Gemini, etc.)

No backend, no subscription — your key talks directly to OpenRouter.

What It Can Do

The assistant has 87 tools across these categories:

  • Create — frames, shapes, text, components, pages. Renders JSX for complex layouts.
  • Style — fills, strokes, effects, opacity, corner radius, blend modes.
  • Layout — auto-layout, alignment, spacing, sizing.
  • Components — create components, instances, component sets. Manage overrides.
  • Variables — create/edit variables, collections, modes. Bind to fills.
  • Query — find nodes, read properties, list pages, fonts, selection.
  • Analyze — color palette, typography audit, spacing consistency, cluster detection.
  • Export — PNG, SVG, JSX with Tailwind classes.
  • Vector — boolean operations, path manipulation.

Example Prompts

  • "Create a card with a title, description, and a blue button"
  • "Make all buttons on this page use the same border radius"
  • "What fonts are used in this file?"
  • "Change the background of the selected frame to a gradient from blue to purple"
  • "Export the selected frame as SVG"
  • "Find all text nodes with font size less than 12"

Tips

  • Select nodes before asking — the assistant knows what's selected.
  • Be specific about colors, sizes, and positions for precise results.
  • The assistant can modify multiple nodes in one message.
  • Use "undo" in the editor if you don't like the result.