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.