Examiner des fichiers avec la CLI

La CLI permet de comprendre la structure d’un fichier sans ouvrir l’éditeur.

bun open-pencil info design.fig
bun open-pencil pages design.fig
bun open-pencil tree design.fig

Résumé

info affiche le format, la version, le nombre de pages et d’objets, la taille de la zone de travail, les polices, les variables et les principales métadonnées.

Pages et arbre

pages énumère les pages. tree affiche la hiérarchie et peut limiter la profondeur, la page ou le nombre de résultats.

Rechercher des objets

find recherche par nom, type ou autres critères.

bun open-pencil find design.fig --name Button
bun open-pencil find design.fig --type TEXT

Afficher un objet

node affiche les propriétés de l’identifiant indiqué, notamment la géométrie, le style, les relations et les données propres à son type.

Variables

variables énumère collections, modes, types et valeurs.

Formats

formats affiche les formats enregistrés et leurs capacités de lecture et d’écriture.

Mode application en direct

Lorsque l’application de bureau est lancée, omettez le fichier : la CLI se connecte via RPC et agit sur la zone de travail active :

openpencil documents list    # list open document/page IDs
openpencil tree              # inspect the active live document
openpencil tree --document-id tab-123 --page-id 0:1
openpencil eval --document-id tab-123 --page-id 0:1 -c "..."

Dans les workflows d’agents, utilisez openpencil documents list --json, puis passez explicitement --document-id et --page-id au lieu de vous fier à l’onglet ou à la page visibles. Pour ouvrir, enregistrer, changer et fermer des documents, annuler, modifier les réglages ou appeler un outil de l’éditeur, consultez Piloter l’application.

Analyser la qualité du design

openpencil lint design.fig
openpencil lint design.pen --preset strict
openpencil lint design.fig --rule color-contrast
openpencil lint design.fig --list-rules
openpencil lint design.fig --fix -o fixed.fig

Utilisez --json pour une sortie exploitable par une machine ; chaque message porte ses fix et suggestions sous forme de données. --fix applique les corrections sûres — liaison des couleurs à la variable de couleur correspondante et arrondi de la géométrie au pixel entier — et écrit le résultat dans le fichier .fig indiqué avec -o.

Sortie JSON

Les commandes de consultation acceptent --json, adapté à jq, la CI et aux programmes qui nécessitent une sortie stable et exploitable par une machine.

bun open-pencil pages design.fig --json | jq '.[].name'

Utilisez bun open-pencil --help ou ajoutez --help à une sous-commande pour voir toutes les options.