Interfaz de linea de comandos

El CLI de Bobcorn te permite gestionar proyectos de fuentes de iconos completamente desde la terminal. Instalalo desde el panel de Configuracion en la aplicacion Bobcorn — haz clic en el boton Instalar en la seccion "Interfaz de linea de comandos".

bobcorn --version

El CLI detecta automaticamente archivos de proyecto .icp en el directorio actual. Tambien puedes especificar una ruta explicitamente. La prioridad de resolucion es:

1. Argumento de ruta explicito — pasado directamente al comando
2. Flag --project — opcion global para todos los comandos
3. Descubrimiento automatico — escanea el directorio actual buscando un archivo .icp

# 1. Argumento de ruta explicito
bobcorn project inspect my-icons.icp

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

# 3. Descubrimiento automatico (ejecutar desde el directorio con el .icp)
cd my-project/
bobcorn icon list

Por defecto, el CLI produce texto legible. Agrega --json para salida JSON estructurada, ideal para scripts e integracion con agentes IA.

Estructura del sobre JSON

Cada respuesta JSON sigue un sobre consistente:

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

Tres estados de respuesta

Crear, inspeccionar y configurar archivos de proyecto .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

Importar, listar, renombrar, mover, copiar, eliminar y configurar iconos. Todas las referencias usan UUID — usa icon list --json para descubrir 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>

Organiza iconos en grupos con nombre. Los grupos controlan el orden de visualizacion en la barra lateral y se pueden usar para filtrar exportaciones.

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 archivos de fuente y exporta SVGs. Soporta SVG, TTF, WOFF, WOFF2 y EOT con archivos CSS y JS opcionales.

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

Busca iconos por nombre y gestiona favoritos marcados.

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

Gestiona variantes de peso y escala de iconos (estilo SF Symbols). La generacion de variantes requiere el GUI de Bobcorn, pero puedes listar y eliminar variantes desde el CLI.

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

El CLI de Bobcorn esta disenado para trabajar sin problemas con agentes de codificacion IA como Claude Code, Codex, Cursor y otros. Usa --json para salida estructurada que los agentes puedan analizar de forma fiable.

Principios clave

• Cada comando soporta --json para salida legible por maquina
• El sobre JSON es consistente en todos los comandos — los agentes pueden confiar en la estructura ok / error / data
• El descubrimiento automatico permite a los agentes simplemente hacer cd al directorio del proyecto y ejecutar comandos sin especificar rutas
• Los codigos de error son predecibles: ICON_NOT_FOUND, GROUP_NOT_FOUND, FILE_IO_ERROR, etc.

Ejemplo de flujo de trabajo del 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

Aqui hay un script bash completo de extremo a extremo que muestra un flujo de trabajo 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 "Listo! Los archivos de fuente estan en ./src/fonts"