Interface en ligne de commande

Le CLI Bobcorn vous permet de gerer entierement vos projets de polices d'icones depuis le terminal. Installez-le depuis le panneau Parametres dans l'application Bobcorn — cliquez sur le bouton Installer dans la section "Interface en ligne de commande".

bobcorn --version

Le CLI detecte automatiquement les fichiers projet .icp dans le repertoire courant. Vous pouvez aussi specifier un chemin explicitement. La priorite de resolution est :

1. Argument de chemin explicite — passe directement a la commande
2. Option --project — option globale pour toutes les commandes
3. Decouverte automatique — recherche un fichier .icp dans le repertoire courant

# 1. Argument de chemin explicite
bobcorn project inspect my-icons.icp

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

# 3. Decouverte automatique (executer depuis le repertoire contenant le .icp)
cd my-project/
bobcorn icon list

Par defaut, le CLI produit du texte lisible. Ajoutez --json pour une sortie JSON structuree, ideale pour les scripts et l'integration avec des agents IA.

Structure de l'enveloppe JSON

Chaque reponse JSON suit une enveloppe coherente :

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

Trois etats de reponse

Creer, inspecter et configurer des fichiers projet .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

Importer, lister, renommer, deplacer, copier, supprimer et configurer des icones. Toutes les references d'icones utilisent des UUID — utilisez icon list --json pour decouvrir les 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>

Organisez les icones en groupes nommes. Les groupes controlent l'ordre d'affichage dans la barre laterale et peuvent etre utilises pour filtrer les exportations.

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>

Generation de fichiers de polices et exportation SVG. L'exportation prend en charge les formats SVG, TTF, WOFF, WOFF2 et EOT avec des fichiers CSS et JS optionnels.

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

Rechercher des icones par nom et gerer les favoris.

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

Gerer les variantes de poids et d'echelle des icones (style SF Symbols). La generation de variantes necessite le GUI Bobcorn, mais vous pouvez lister et supprimer des variantes depuis le CLI.

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

Le CLI Bobcorn est concu pour fonctionner de maniere transparente avec les agents de codage IA tels que Claude Code, Codex, Cursor et autres. Utilisez --json pour une sortie structuree que les agents peuvent analyser de maniere fiable.

Principes cles

• Chaque commande prend en charge --json pour une sortie lisible par machine
• L'enveloppe JSON est coherente pour toutes les commandes — les agents peuvent s'appuyer sur la structure ok / error / data
• La decouverte automatique signifie que les agents peuvent simplement cd dans un repertoire de projet et executer des commandes sans specifier de chemins
• Les codes d'erreur sont previsibles : ICON_NOT_FOUND, GROUP_NOT_FOUND, FILE_IO_ERROR, etc.

Exemple de workflow d'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

Voici un script bash complet de bout en bout montrant un workflow typique de police d'icones :

#!/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 "Termine ! Les fichiers de police sont dans ./src/fonts"