Dateien untersuchen

Die CLI liest .fig-Dateien, ohne den Editor zu öffnen. Läuft die Desktop-App, kann der Dateiname entfallen; die CLI verwendet dann RPC für das geöffnete Dokument.

Installation

npm install -g @open-pencil/cli
# oder
bun add -g @open-pencil/cli

Dokumentinformationen

openpencil info design.fig

Zeigt Seiten, Objektanzahl, verwendete Schriften und Dateigröße.

Dokumentbaum und Suche

openpencil tree design.fig
openpencil find design.fig --type TEXT
openpencil find design.fig --name "Button"

XPath-Abfragen

openpencil query design.fig "//FRAME"
openpencil query design.fig "//TEXT[@fontSize >= 24]"
openpencil query design.fig "//*[@visible = false]"

Attributnamen wie fontSize, layoutMode und strokeWeight entsprechen der API und bleiben unverändert.

Objekte, Seiten und Variablen

openpencil node design.fig --id 1:23
openpencil pages design.fig
openpencil variables design.fig

Geöffnetes Dokument

openpencil documents list
openpencil tree --document-id tab-123 --page-id 0:1

Für automatisierte Abläufe zuerst openpencil documents list --json aufrufen und anschließend --document-id und --page-id ausdrücklich übergeben. Dokumente öffnen, speichern, wechseln und schließen, Rückgängig machen, Einstellungen ändern und beliebige Editor-Werkzeuge aufrufen: siehe Controlling the App.

Qualitätsprüfung

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

Alle Befehle unterstützen --json; jede Meldung enthält ihre fix- und suggestions-Angaben als Daten. --fix wendet die sicheren Korrekturen an – Farben werden an die passende Farbvariable gebunden und die Geometrie auf ganze Pixel gerundet – und schreibt das Ergebnis in die mit -o angegebene .fig-Datei.