Opdrachtregelinterface

Met de Bobcorn CLI kun je icon-font-projecten volledig vanuit de terminal beheren. Installeer het vanuit het Instellingen-paneel in de Bobcorn-app — klik op de Installeren-knop in het gedeelte "Opdrachtregelinterface".

bobcorn --version

De CLI detecteert automatisch .icp-projectbestanden in de huidige map. Je kunt ook expliciet een pad opgeven. De resolutieprioriteit is:

1. Expliciet padargument — direct doorgegeven aan het commando
2. --project vlag — globale optie voor alle commando's
3. Automatische detectie — scant de huidige map naar een .icp-bestand

# 1. Expliciet padargument
bobcorn project inspect my-icons.icp

# 2. Globale --project vlag
bobcorn --project my-icons.icp icon list

# 3. Automatische detectie (uitvoeren vanuit de map met het .icp-bestand)
cd my-project/
bobcorn icon list

Standaard geeft de CLI leesbare tekst uit. Voeg --json toe voor gestructureerde JSON-uitvoer, ideaal voor scripting en AI-agent-integratie.

JSON-envelopstructuur

Elke JSON-respons volgt een consistente envelop:

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

Drie responsstatussen

.icp-projectbestanden aanmaken, inspecteren en configureren.

# 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

Iconen importeren, weergeven, hernoemen, verplaatsen, kopieren, verwijderen en configureren. Alle iconenreferenties gebruiken UUID — gebruik icon list --json om ID's te ontdekken.

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>

Organiseer iconen in benoemde groepen. Groepen bepalen de weergavevolgorde in de zijbalk en kunnen worden gebruikt om exports te filteren.

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>

Genereer fontbestanden en exporteer SVG's. Ondersteunt SVG, TTF, WOFF, WOFF2 en EOT met optionele CSS- en JS-bestanden.

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

Zoek iconen op naam en beheer favorieten.

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

Beheer gewichts- en schaalvarianten van iconen (SF Symbols-stijl). Het genereren van varianten vereist de Bobcorn-GUI, maar je kunt varianten weergeven en verwijderen via de CLI.

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

De Bobcorn CLI is ontworpen voor naadloze samenwerking met AI-codeeragenten zoals Claude Code, Codex, Cursor en anderen. Gebruik --json voor gestructureerde uitvoer die agenten betrouwbaar kunnen verwerken.

Kernprincipes

• Elk commando ondersteunt --json voor machineleesbare uitvoer
• De JSON-envelop is consistent voor alle commando's — agenten kunnen vertrouwen op de ok / error / data-structuur
• Automatische projectdetectie betekent dat agenten gewoon cd kunnen doen naar een projectmap en commando's kunnen uitvoeren zonder paden
• Foutcodes zijn voorspelbaar: ICON_NOT_FOUND, GROUP_NOT_FOUND, FILE_IO_ERROR, enz.

Agent-workflowvoorbeeld

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 is een compleet end-to-end bash-script dat een typische workflow toont:

#!/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 "Klaar! Fontbestanden staan in ./src/fonts"