openpencil/packages/docs/de/programmable/cli/inspecting.md
Danila Poyarkov 904f3ca390
fix: use official Homebrew cask installation guidance (#712)
* fix: use official Homebrew cask installation guidance

* docs: guide localized pages through the old Homebrew tap

The translated getting-started pages documented the official cask but not
the migration from the archived tap, so readers of those pages had no
uninstall step for the old formula.
2026-09-17 13:36:17 +03:00

1.5 KiB

title description
Dateien untersuchen Dokumentbaum, Objekte, Seiten und Variablen über die CLI lesen.

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.

::: tip 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
openpencil tree --document-id tab-123 --page-id 0:1

Für automatisierte Abläufe zuerst openpencil documents --json aufrufen und anschließend --document-id und --page-id ausdrücklich übergeben.

Qualitätsprüfung

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

Alle Befehle unterstützen --json.