Befehlszeilenschnittstelle

Mit dem Bobcorn CLI koennen Sie Icon-Font-Projekte vollstaendig ueber das Terminal verwalten. Installieren Sie es ueber das Einstellungen-Panel in der Bobcorn-App — klicken Sie auf den Installieren-Button im Abschnitt "Befehlszeilenschnittstelle".

bobcorn --version

Das CLI erkennt automatisch .icp-Projektdateien im aktuellen Verzeichnis. Sie koennen auch explizit einen Pfad angeben. Die Aufloesung hat folgende Prioritaet:

1. Explizites Pfadargument — direkt an den Befehl uebergeben
2. --project Flag — globale Option fuer alle Befehle
3. Automatische Erkennung — scannt das aktuelle Verzeichnis nach einer .icp-Datei

# 1. Explizites Pfadargument
bobcorn project inspect my-icons.icp

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

# 3. Automatische Erkennung (aus dem Verzeichnis mit der .icp-Datei ausfuehren)
cd my-project/
bobcorn icon list

Standardmaessig gibt das CLI menschenlesbaren Text aus. Fuegen Sie --json hinzu fuer strukturierte JSON-Ausgabe, ideal fuer Scripting und KI-Agenten-Integration.

JSON-Huellenstruktur

Jede JSON-Antwort folgt einer einheitlichen Huelle:

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

Drei Antwortzustaende

.icp-Projektdateien erstellen, untersuchen und konfigurieren.

# 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

Icons importieren, auflisten, umbenennen, verschieben, kopieren, loeschen und konfigurieren. Alle Icon-Referenzen verwenden UUID — icon list --json zum Ermitteln von IDs.

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>

Icons in benannte Gruppen organisieren. Gruppen steuern die Anzeigereihenfolge in der Seitenleiste und koennen zum Filtern von Exporten verwendet werden.

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>

Font-Dateien generieren und SVGs exportieren. Unterstuetzt SVG, TTF, WOFF, WOFF2 und EOT mit optionalen CSS- und JS-Begleitdateien.

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

Icons nach Name suchen und Lesezeichen-Favoriten verwalten.

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

Icon-Gewichts- und Skalierungsvarianten (SF Symbols Stil) verwalten. Die Variantengenerierung erfordert die Bobcorn-GUI, aber Auflisten und Loeschen ist ueber das CLI moeglich.

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

Das Bobcorn CLI ist fuer nahtlose Zusammenarbeit mit KI-Coding-Agenten wie Claude Code, Codex, Cursor und anderen konzipiert. Verwenden Sie --json fuer strukturierte Ausgabe, die Agenten zuverlaessig parsen koennen.

Grundprinzipien

• Jeder Befehl unterstuetzt --json fuer maschinenlesbare Ausgabe
• Die JSON-Huelle ist bei allen Befehlen konsistent — Agenten koennen sich auf die ok / error / data-Struktur verlassen
• Automatische Projekterkennung ermoeglicht es Agenten, einfach in ein Projektverzeichnis zu cd-en und Befehle ohne Pfadangabe auszufuehren
• Fehlercodes sind vorhersehbar: ICON_NOT_FOUND, GROUP_NOT_FOUND, FILE_IO_ERROR usw.

Agenten-Workflow-Beispiel

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

Hier ist ein vollstaendiges End-to-End-Bash-Skript, das einen typischen Icon-Font-Workflow zeigt:

#!/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 "Fertig! Font-Dateien befinden sich in ./src/fonts"