อินเทอร์เฟซบรรทัดคำสั่ง

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 agent

โครงสร้างซอง 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 ออกแบบมาเพื่อทำงานร่วมกับ AI coding agent เช่น Claude Code, Codex, Cursor และอื่น ๆ ได้อย่างราบรื่น ใช้ --json สำหรับเอาต์พุตที่มีโครงสร้างซึ่ง agent สามารถแยกวิเคราะห์ได้อย่างน่าเชื่อถือ

หลักการสำคัญ

• ทุกคำสั่งรองรับ --json สำหรับเอาต์พุตที่เครื่องอ่านได้
• ซอง JSON สม่ำเสมอในทุกคำสั่ง — agent สามารถพึ่งพาโครงสร้าง ok / error / data
• การค้นพบอัตโนมัติหมายความว่า agent แค่ cd ไปยังไดเรกทอรีโปรเจกต์แล้วรันคำสั่งได้โดยไม่ต้องระบุพาธ
• รหัสข้อผิดพลาดคาดเดาได้: ICON_NOT_FOUND, GROUP_NOT_FOUND, FILE_IO_ERROR ฯลฯ

ตัวอย่างเวิร์กโฟลว์ของ 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

นี่คือสคริปต์ 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"