Eleven translated pages changed in English since the last release without matching updates: system requirements, the Lint tab, AI chat diff tools, collaboration with agents, design JSX imports and export fidelity, Storybook and live-app export, lint fixes, page navigation, and Checking Designs. Bring de, es, fr, it, pl, and ru up to date, add the sections the abridged translations lacked where a change landed, use each language's UI labels, and point the export page at documents list.
3 KiB
| title | description |
|---|---|
| Examinar archivos con la CLI | Consultar páginas, objetos, jerarquías, variables y formatos de documentos `.fig`. |
Examinar archivos con la CLI
La CLI permite conocer la estructura de un archivo sin abrir el editor.
bun open-pencil info design.fig
bun open-pencil pages design.fig
bun open-pencil tree design.fig
Resumen
info muestra formato, versión, número de páginas y objetos, tamaño del lienzo, fuentes, variables y metadatos principales.
Páginas y árbol
pages enumera las páginas. tree imprime la jerarquía y puede limitar profundidad, página o número de resultados.
bun open-pencil tree design.fig --depth 3
Buscar objetos
find busca por nombre, tipo u otras condiciones.
bun open-pencil find design.fig --name Button
bun open-pencil find design.fig --type TEXT
Ver un objeto
node muestra las propiedades del identificador indicado, incluidas geometría, estilo, relaciones y datos específicos de su tipo.
bun open-pencil node design.fig 12:34
Variables
variables enumera colecciones, modos, tipos y valores.
bun open-pencil variables design.fig
Formatos
formats lista los formatos de documento registrados y sus capacidades de lectura y escritura.
Aplicación en ejecución
Cuando la aplicación de escritorio está abierta, omite el archivo: la CLI se conecta por RPC y opera sobre el lienzo en vivo:
bun open-pencil documents list # lista los ID de documentos y páginas abiertos
bun open-pencil tree # inspecciona el documento activo
bun open-pencil tree --document-id tab-123 --page-id 0:1
bun open-pencil eval --document-id tab-123 --page-id 0:1 -c "..."
En flujos con agentes, usa bun open-pencil documents list --json y pasa --document-id y --page-id de forma explícita en lugar de depender de la pestaña o página visible. Para abrir, guardar, cambiar y cerrar documentos, deshacer, modificar ajustes o llamar a cualquier herramienta del editor, consulta Controlar la aplicación.
Lint
lint revisa un diseño con reglas de accesibilidad y consistencia.
bun open-pencil lint design.fig
bun open-pencil lint design.pen --preset strict
bun open-pencil lint design.fig --rule color-contrast
bun open-pencil lint design.fig --list-rules
bun open-pencil lint design.fig --fix -o fixed.fig
Usa --json para una salida legible por máquinas; cada mensaje incluye su fix y sus suggestions como datos. --fix aplica las correcciones seguras —enlazar los colores a la variable de color que coincide y redondear la geometría a píxeles enteros— y escribe el resultado en el archivo .fig indicado con -o.
Salida JSON
Los comandos de consulta admiten --json, apropiado para jq, CI y programas que necesiten una salida estable y legible por máquinas.
bun open-pencil pages design.fig --json | jq '.[].name'
Usa bun open-pencil --help o añade --help a un subcomando para ver todas las opciones.