Antarmuka Baris Perintah

CLI Bobcorn memungkinkan Anda mengelola proyek font ikon sepenuhnya dari terminal. Instal dari panel Pengaturan di aplikasi Bobcorn — klik tombol Instal di bagian "Antarmuka Baris Perintah".

bobcorn --version

CLI secara otomatis mendeteksi file proyek .icp di direktori saat ini. Anda juga dapat menentukan path secara eksplisit. Prioritas resolusi:

1. Argumen path eksplisit — diteruskan langsung ke perintah
2. Flag --project — opsi global untuk semua perintah
3. Penemuan otomatis — memindai direktori saat ini untuk file .icp

# 1. Argumen path eksplisit
bobcorn project inspect my-icons.icp

# 2. Flag global --project
bobcorn --project my-icons.icp icon list

# 3. Penemuan otomatis (jalankan dari direktori yang berisi file .icp)
cd my-project/
bobcorn icon list

Secara default CLI menghasilkan teks yang dapat dibaca. Tambahkan --json untuk output JSON terstruktur, ideal untuk skrip dan integrasi AI agent.

Struktur amplop JSON

Setiap respons JSON mengikuti amplop yang konsisten:

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

Tiga status respons

Membuat, memeriksa, dan mengkonfigurasi file proyek .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

Impor, daftar, ganti nama, pindahkan, salin, hapus, dan konfigurasi ikon. Semua referensi ikon menggunakan UUID — gunakan icon list --json untuk menemukan 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>

Atur ikon ke dalam grup bernama. Grup mengontrol urutan tampilan di sidebar dan dapat digunakan untuk memfilter ekspor.

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>

Buat file font dan ekspor SVG. Mendukung SVG, TTF, WOFF, WOFF2, dan EOT dengan file CSS dan JS opsional.

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

Cari ikon berdasarkan nama dan kelola favorit yang ditandai.

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

Kelola varian bobot dan skala ikon (gaya SF Symbols). Pembuatan varian memerlukan GUI Bobcorn, tetapi Anda dapat mendaftar dan menghapus varian dari CLI.

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

CLI Bobcorn dirancang untuk bekerja mulus dengan AI coding agent seperti Claude Code, Codex, Cursor, dan lainnya. Gunakan --json untuk output terstruktur yang dapat diurai agent secara andal.

Prinsip utama

• Setiap perintah mendukung --json untuk output yang dapat dibaca mesin
• Amplop JSON konsisten di semua perintah — agent dapat mengandalkan struktur ok / error / data
• Penemuan otomatis proyek memungkinkan agent cukup cd ke direktori proyek dan menjalankan perintah tanpa menentukan path
• Kode error dapat diprediksi: ICON_NOT_FOUND, GROUP_NOT_FOUND, FILE_IO_ERROR, dll.

Contoh alur kerja 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

Berikut adalah skrip bash lengkap end-to-end yang menunjukkan alur kerja font ikon yang khas:

#!/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 "Selesai! File font ada di ./src/fonts"