Интерфейс командной строки

CLI Bobcorn позволяет полностью управлять проектами иконочных шрифтов из терминала. Установите его из панели Настройки в приложении Bobcorn — нажмите кнопку Установить в разделе «Интерфейс командной строки».

В режиме разработки команда регистрируется как bobcorn-dev; продакшен-сборки устанавливают bobcorn. После установки откройте новый терминал и проверьте:

bobcorn --version

CLI автоматически обнаруживает файлы проекта .icp в текущем каталоге. Путь можно указать явно. Приоритет разрешения:

1. Явный аргумент пути — передается команде напрямую
2. Флаг --project — глобальная опция для всех команд
3. Автообнаружение — сканирует текущий каталог на наличие файла .icp

# 1. Явный аргумент пути
bobcorn project inspect my-icons.icp

# 2. Глобальный флаг --project
bobcorn --project my-icons.icp icon list

# 3. Автообнаружение (запустить из каталога с файлом .icp)
cd my-project/
bobcorn icon list

По умолчанию CLI выводит читаемый текст. Добавьте --json для структурированного JSON-вывода, идеального для скриптов и интеграции с ИИ-агентами.

Структура JSON-конверта

Каждый JSON-ответ следует единому формату:

{
  "ok": true,
  "data": { ... },
  "meta": {
    "command": "icon list",
    "projectPath": "/path/to/project.icp",
    "duration_ms": 42,
    "version": "1.0.0"
  }
}

Три состояния ответа

Создание, проверка и настройка файлов проекта .icp.

# Create a new empty project
bobcorn project create my-icons.icp --name "App Icons"

# Inspect project metadata
bobcorn project inspect

# Set project name / font prefix
bobcorn project set-name "New Name"

# Set font prefix (alias)
bobcorn project set-prefix "MyIcons"

# Save a copy
bobcorn project save-as backup.icp

Импорт, просмотр, переименование, перемещение, копирование, удаление и настройка иконок. Все ссылки используют UUID — icon list --json для получения ID.

bobcorn icon import *.svg --group Navigation
bobcorn icon list
bobcorn icon list --group Navigation --json
bobcorn icon rename <id> new-name
bobcorn icon move <id1> <id2> --to "Other Group"
bobcorn icon copy <id> --to "Backup"
bobcorn icon delete <id>
bobcorn icon set-code <id> E100
bobcorn icon replace <id> new-icon.svg
bobcorn icon export-svg <id> --out ./exports
bobcorn icon set-favorite <id>
bobcorn icon set-favorite <id> --off
bobcorn icon set-color <id> --from "#000" --to "#333"
bobcorn icon get-content <id>

Организуйте иконки в именованные группы. Группы управляют порядком отображения в боковой панели и могут использоваться для фильтрации экспорта.

bobcorn group list
bobcorn group add "New Category"
bobcorn group rename "Old Name" "New Name"
bobcorn group delete "Empty Group"
bobcorn group reorder Navigation Actions Settings
bobcorn group set-description Navigation "Main nav icons"
bobcorn group move-icons Navigation <id1> <id2>

Генерация файлов шрифтов и экспорт SVG. Поддержка SVG, TTF, WOFF, WOFF2 и EOT с дополнительными файлами CSS и JS.

bobcorn export font --out ./dist --formats woff2,ttf
bobcorn export font --out ./dist --font-name "MyIcons" --css --js
bobcorn export svg --out ./svg-icons
bobcorn export svg --out ./svg-icons --group Navigation

Поиск иконок по имени и управление избранным.

bobcorn search "arrow"
bobcorn search "home" --group Navigation --limit 10
bobcorn favorite list

Управление вариантами веса и масштаба иконок (стиль SF Symbols). Генерация вариантов требует GUI Bobcorn, но просмотр и удаление доступны из CLI.

bobcorn variant list <id>
bobcorn variant delete <id>

CLI Bobcorn создан для бесшовной работы с ИИ-агентами: Claude Code, Codex, Cursor и другими. Используйте --json для структурированного вывода, который агенты могут надежно обрабатывать.

Ключевые принципы

• Каждая команда поддерживает --json для машиночитаемого вывода
• JSON-конверт одинаков для всех команд — агенты могут полагаться на структуру ok / error / data
• Автообнаружение проекта позволяет агентам просто сделать cd в каталог проекта и выполнять команды без указания путей
• Коды ошибок предсказуемы: ICON_NOT_FOUND, GROUP_NOT_FOUND, FILE_IO_ERROR и др.

Пример рабочего процесса агента

bobcorn project create app-icons.icp --name "MyApp" --json
bobcorn icon import ./design/*.svg --json
bobcorn group add "Navigation" --json
bobcorn group add "Actions" --json
NAV_IDS=$(bobcorn search "nav" --json | jq -r '.data[].id')
bobcorn icon move $NAV_IDS --to "Navigation" --json
bobcorn export font --out ./src/fonts --formats woff2 --json

Полный bash-скрипт, демонстрирующий типичный рабочий процесс:

#!/bin/bash
set -e

bobcorn project create my-app-icons.icp --name "MyApp"
bobcorn icon import ./design/icons/*.svg
bobcorn group add "Navigation"
bobcorn group add "Actions"
bobcorn group add "Status"

NAV_ICONS=$(bobcorn search "nav" --json | jq -r '.data[].id')
for id in $NAV_ICONS; do
  bobcorn icon move "$id" --to "Navigation"
done

bobcorn group reorder Navigation Actions Status
bobcorn export font --out ./src/fonts --formats woff2 --css
bobcorn export svg --out ./docs/icons

echo "Готово! Файлы шрифтов в ./src/fonts"