Danila Poyarkov 883782846f docs(cli): use released openpencil command

2026-05-29 15:56:52 +03:00

2 KiB

Raw Blame History

title	description
Ispezione dei File	Esplora alberi di nodi, cerca per nome o tipo e analizza le proprietà dal terminale.

Ispezione dei File

La CLI ti permette di esplorare file .fig senza aprire l'editor. Ogni comando funziona anche con l'app in esecuzione — basta omettere l'argomento del file.

::: tip Installazione

npm install -g @open-pencil/cli
# oppure
brew install open-pencil/tap/open-pencil

:::

Informazioni sul Documento

Ottieni una panoramica rapida — conteggio pagine, nodi totali, font utilizzati, dimensione del file:

openpencil info design.fig

Albero dei Nodi

Stampa l'intera gerarchia dei nodi:

openpencil 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)

Trova Nodi

Cerca per tipo:

openpencil find design.fig --type TEXT

Cerca per nome:

openpencil find design.fig --name "Button"

Entrambi i flag possono essere combinati per restringere ulteriormente i risultati.

Dettagli del Nodo

Ispeziona tutte le proprietà di un nodo specifico tramite il suo ID:

openpencil node design.fig --id 1:23

Pagine

Elenca tutte le pagine del documento:

openpencil pages design.fig

Variabili

Elenca le variabili di design e le relative collezioni:

openpencil variables design.fig

Modalità App in Esecuzione

Quando l'app desktop è in esecuzione, ometti l'argomento del file — la CLI si connette tramite RPC e opera sul canvas attivo:

openpencil tree              # ispeziona il documento attivo
openpencil eval -c "..."     # interroga l'editor

Output JSON

Tutti i comandi supportano --json per output leggibile dalle macchine — invia tramite pipe a jq, usa negli script CI o elabora con altri strumenti:

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

2 KiB Raw Blame History