openpencil/packages/docs/de/programmable/cli/inspecting.md
Danila Poyarkov bfa4b7de8b Translate AI & Automation + CLI reference to all 6 locales
48 translated pages (de, es, fr, it, pl, ru) for the Programmable
section: overview, AI Chat, Collaboration, JSX Renderer, CLI
(inspecting, exporting, analyzing, scripting).

CLI reference and MCP server pages copied as-is (mostly code/tables).
2026-03-08 18:25:35 +03:00

2 KiB

title description
Dateien inspizieren Knotenbäume durchsuchen, nach Name oder Typ suchen und Eigenschaften im Terminal untersuchen.

Dateien inspizieren

Das CLI ermöglicht es, .fig-Dateien zu erkunden, ohne den Editor zu öffnen. Jeder Befehl funktioniert auch mit der laufenden App — lass einfach das Dateiargument weg.

::: tip Installation

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

:::

Dokumentinformationen

Erhalte einen schnellen Überblick — Seitenanzahl, Gesamtknoten, verwendete Schriften, Dateigröße:

open-pencil info design.fig

Knotenbaum

Gibt die vollständige Knotenhierarchie aus:

open-pencil tree design.fig
[0] [page] "Getting started" (0:46566)
  [0] [section] "" (0:46567)
    [0] [frame] "Body" (0:46568)
      [0] [frame] "Introduction" (0:46569)
        [0] [frame] "Introduction Card" (0:46570)
          [0] [frame] "Guidance" (0:46571)

Knoten finden

Nach Typ suchen:

open-pencil find design.fig --type TEXT

Nach Name suchen:

open-pencil find design.fig --name "Button"

Beide Flags können kombiniert werden, um Ergebnisse weiter einzugrenzen.

Knotendetails

Alle Eigenschaften eines bestimmten Knotens anhand seiner ID inspizieren:

open-pencil node design.fig --id 1:23

Seiten

Alle Seiten im Dokument auflisten:

open-pencil pages design.fig

Variablen

Designvariablen und ihre Sammlungen auflisten:

open-pencil variables design.fig

Live-App-Modus

Wenn die Desktop-App läuft, lass das Dateiargument weg — das CLI verbindet sich über RPC und arbeitet auf der Live-Zeichenfläche:

open-pencil tree              # das Live-Dokument inspizieren
open-pencil eval -c "..."     # den Editor abfragen

JSON-Ausgabe

Alle Befehle unterstützen --json für maschinenlesbare Ausgabe — weiterleiten an jq, in CI-Skripte einspeisen oder mit anderen Werkzeugen verarbeiten:

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