Interfaccia a riga di comando

Il CLI di Bobcorn ti permette di gestire completamente i progetti di font icone dal terminale. Installalo dal pannello Impostazioni nell'app Bobcorn — clicca il pulsante Installa nella sezione "Interfaccia a riga di comando".

bobcorn --version

Il CLI rileva automaticamente i file progetto .icp nella directory corrente. Puoi anche specificare un percorso esplicitamente. La priorita di risoluzione e:

1. Argomento di percorso esplicito — passato direttamente al comando
2. Flag --project — opzione globale per tutti i comandi
3. Rilevamento automatico — scansiona la directory corrente per un file .icp

# 1. Argomento di percorso esplicito
bobcorn project inspect my-icons.icp

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

# 3. Rilevamento automatico (eseguire dalla directory contenente il .icp)
cd my-project/
bobcorn icon list

Per impostazione predefinita, il CLI produce testo leggibile. Aggiungi --json per output JSON strutturato, ideale per scripting e integrazione con agenti IA.

Struttura dell'involucro JSON

Ogni risposta JSON segue un involucro coerente:

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

Tre stati di risposta

Crea, ispeziona e configura file progetto .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

Importa, elenca, rinomina, sposta, copia, elimina e configura icone. Tutti i riferimenti usano UUID — usa icon list --json per scoprire gli 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>

Organizza le icone in gruppi nominati. I gruppi controllano l'ordine di visualizzazione nella barra laterale e possono essere usati per filtrare le esportazioni.

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>

Genera file font ed esporta SVG. Supporta SVG, TTF, WOFF, WOFF2 ed EOT con file CSS e JS opzionali.

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

Cerca icone per nome e gestisci i preferiti.

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

Gestisci varianti di peso e scala delle icone (stile SF Symbols). La generazione di varianti richiede la GUI Bobcorn, ma puoi elencare ed eliminare varianti dal CLI.

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

Il CLI Bobcorn e progettato per funzionare perfettamente con agenti di codifica IA come Claude Code, Codex, Cursor e altri. Usa --json per output strutturato che gli agenti possano analizzare in modo affidabile.

Principi chiave

• Ogni comando supporta --json per output leggibile da macchina
• L'involucro JSON e coerente in tutti i comandi — gli agenti possono fare affidamento sulla struttura ok / error / data
• Il rilevamento automatico permette agli agenti di fare semplicemente cd nella directory del progetto ed eseguire comandi senza specificare percorsi
• I codici di errore sono prevedibili: ICON_NOT_FOUND, GROUP_NOT_FOUND, FILE_IO_ERROR, ecc.

Esempio di workflow dell'agente

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

Ecco uno script bash completo end-to-end che mostra un workflow tipico:

#!/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 "Fatto! I file font sono in ./src/fonts"