openpencil/packages/docs/it/programmable/cli/inspecting.md

---
title: Ispezione dei File
description: 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
```sh
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:

```sh
openpencil info design.fig
```

## Albero dei Nodi

Stampa l'intera gerarchia dei nodi:

```sh
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:

```sh
openpencil find design.fig --type TEXT
```

Cerca per nome:

```sh
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:

```sh
openpencil node design.fig --id 1:23
```

## Pagine

Elenca tutte le pagine del documento:

```sh
openpencil pages design.fig
```

## Variabili

Elenca le variabili di design e le relative collezioni:

```sh
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:

```sh
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:

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