명령줄 인터페이스

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을 추가하면 스크립팅과 AI 에이전트 통합에 적합한 구조화된 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 스타일) 관리. 변형 생성에는 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에 있습니다"