openfig-cli
v0.3.42
Published
OpenFig — Open-source tools for Figma file parsing and rendering
Maintainers
Readme
Open tools for Figma files.
Parse, inspect, render, and modify .deck and .fig files without the Figma application.
Install
npm install -g openfig-cliNode 18+. No build step. Pure ESM.
File Format Support
| Product | Extension | Read | Render | Modify |
|---------|-----------|------|--------|--------|
| Figma Slides | .deck | ✅ | ✅ PNG / PDF | ✅ |
| Figma Design | .fig | ✅ | ✅ PNG / PDF | ✅ |
CLI
# Read & inspect (works on .deck and .fig)
openfig inspect deck.deck # node hierarchy tree
openfig list-text deck.deck # all text and image content per slide
openfig list-overrides deck.deck # editable override keys per symbol
# Render (works on .deck and .fig)
openfig export deck.deck # export slides/frames as PNG
openfig pdf deck.deck # export as multi-page PDF
# Modify (.deck only)
openfig update-text deck.deck -o out.deck --slide <id> --set "key=value"
openfig insert-image deck.deck -o out.deck --slide <id> --key <nodeId> --image <path>
openfig clone-slide deck.deck -o out.deck --template <id|name> --name <name> [--set key=value ...]
openfig remove-slide deck.deck -o out.deck --slide <id>
openfig roundtrip in.deck out.deck # decode + re-encode validationFull CLI reference: docs/cli.md
Why native .deck?
Figma Slides lets you download and re-upload .deck files losslessly. Exporting to .pptx is lossy — vectors rasterize, fonts fall back, layout breaks. OpenFig makes this native round-trip programmable: download, modify, re-upload.
Plug in Claude Cowork or any coding agent and you have an AI that can read and edit Figma presentations end-to-end — without opening the Figma UI.
Agentic / MCP Integration
Install guide, MCP workflows, and template states: docs/agentic/claude-cowork.md
Docs
| | | |---|---| | MCP / Claude workflows | docs/mcp.md | | High-level API | docs/api-spec.md | | Low-level FigDeck API | docs/library.md | | Template workflows | docs/template-workflows.md | | File format internals | docs/format/ (canonical source) |
License
MIT
Disclaimer
Figma is a trademark of Figma, Inc.
OpenFig is an independent open-source project and is not affiliated with, endorsed by, or sponsored by Figma, Inc.
