コマンドラインインターフェース

Bobcorn CLI を使えば、ターミナルから完全にアイコンフォントプロジェクトを管理できます。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 出力が得られ、スクリプトや AI エージェント統合に最適です。

JSON エンベロープ構造

すべての JSON レスポンスは一貫したエンベロープに従います：

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

3つのレスポンス状態

.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 スタイル）を管理。バリアント生成には Bobcorn GUI が必要ですが、CLI から一覧表示と削除が可能です。

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

Bobcorn CLI は Claude Code、Codex、Cursor などの AI コーディングエージェントとシームレスに連携するよう設計されています。--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 にあります"