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

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

Установка

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

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

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

open-pencil info design.fig

Дерево узлов

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

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)

Поиск узлов

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

open-pencil find design.fig --type TEXT

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

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

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

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

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

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

Страницы

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

open-pencil pages design.fig

Переменные

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

open-pencil variables design.fig

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

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

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

JSON-вывод

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

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