Giao dien dong lenh

Bobcorn CLI cho phep ban quan ly du an font bieu tuong hoan toan tu terminal. Cai dat tu bang Cai dat trong ung dung Bobcorn — nhan nut Cai dat trong phan "Giao dien dong lenh".

bobcorn --version

CLI tu dong phat hien cac tap tin du an .icp trong thu muc hien tai. Ban cung co the chi dinh duong dan ro rang. Thu tu uu tien:

1. Doi so duong dan ro rang — truyen truc tiep cho lenh
2. Co --project — tuy chon toan cuc cho tat ca cac lenh
3. Tu dong phat hien — quet thu muc hien tai tim tap tin .icp

# 1. Doi so duong dan ro rang
bobcorn project inspect my-icons.icp

# 2. Co toan cuc --project
bobcorn --project my-icons.icp icon list

# 3. Tu dong phat hien (chay tu thu muc chua tap tin .icp)
cd my-project/
bobcorn icon list

Mac dinh CLI xuat van ban doc duoc. Them --json de co dau ra JSON co cau truc, ly tuong cho script va tich hop AI agent.

Cau truc phong bi JSON

Moi phan hoi JSON theo mot phong bi nhat quan:

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

Ba trang thai phan hoi

Tao, kiem tra va cau hinh tap tin du an .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

Nhap, liet ke, doi ten, di chuyen, sao chep, xoa va cau hinh bieu tuong. Tat ca tham chieu su dung UUID — dung icon list --json de tim 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>

To chuc bieu tuong thanh cac nhom duoc dat ten. Nhom kiem soat thu tu hien thi trong thanh ben va co the dung de loc xuat.

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>

Tao tap tin font va xuat SVG. Ho tro SVG, TTF, WOFF, WOFF2 va EOT voi tap tin CSS va JS tuy chon.

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

Tim bieu tuong theo ten va quan ly danh sach yeu thich.

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

Quan ly bien the trong luong va ti le cua bieu tuong (kieu SF Symbols). Tao bien the can GUI Bobcorn, nhung ban co the liet ke va xoa bien the tu CLI.

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

Bobcorn CLI duoc thiet ke de hoat dong lien mach voi cac AI coding agent nhu Claude Code, Codex, Cursor va nhieu hon. Su dung --json cho dau ra co cau truc ma agent co the phan tich dang tin cay.

Nguyen tac chinh

• Moi lenh ho tro --json cho dau ra may doc duoc
• Phong bi JSON nhat quan tren tat ca lenh — agent co the dua vao cau truc ok / error / data
• Tu dong phat hien du an cho phep agent chi can cd vao thu muc du an va chay lenh ma khong can chi dinh duong dan
• Ma loi co the du doan: ICON_NOT_FOUND, GROUP_NOT_FOUND, FILE_IO_ERROR, v.v.

Vi du quy trinh lam viec cua Agent

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

Day la script bash day du minh hoa quy trinh lam viec font bieu tuong dien hinh:

#!/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 "Hoan tat! Tap tin font nam trong ./src/fonts"