---
title: Просмотр файлов
description: Просматривайте деревья узлов, ищите по имени или типу и изучайте свойства из терминала.
---

# Просмотр файлов

CLI позволяет исследовать файлы `.fig` без открытия редактора. Каждая команда также работает с запущенным приложением — просто опустите аргумент файла.

::: tip Установка
```sh
bun add -g @open-pencil/cli
# или
brew install open-pencil/tap/open-pencil
```
:::

## Информация о документе

Краткий обзор — количество страниц, общее число узлов, используемые шрифты, размер файла:

```sh
open-pencil info design.fig
```

## Дерево узлов

Вывод полной иерархии узлов:

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

## Поиск узлов

Поиск по типу:

```sh
open-pencil find design.fig --type TEXT
```

Поиск по имени:

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

Оба флага можно комбинировать для более точных результатов.

## Свойства узла

Просмотр всех свойств конкретного узла по его ID:

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

## Страницы

Список всех страниц в документе:

```sh
open-pencil pages design.fig
```

## Переменные

Список дизайн-переменных и их коллекций:

```sh
open-pencil variables design.fig
```

## Режим работы с приложением

Когда настольное приложение запущено, опустите аргумент файла — CLI подключится по RPC и будет работать с активным холстом:

```sh
open-pencil tree              # просмотр текущего документа
open-pencil eval -c "..."     # запрос к редактору
```

## JSON-вывод

Все команды поддерживают `--json` для машиночитаемого вывода — передавайте в `jq`, используйте в CI-скриптах или обрабатывайте другими инструментами:

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