Interface de Linha de Comando

O CLI do Bobcorn permite gerenciar projetos de fontes de icones inteiramente pelo terminal. Instale-o no painel de Configuracoes do aplicativo Bobcorn — clique no botao Instalar na secao "Interface de Linha de Comando".

bobcorn --version

O CLI detecta automaticamente arquivos de projeto .icp no diretorio atual. Voce tambem pode especificar um caminho explicitamente. A prioridade de resolucao e:

1. Argumento de caminho explicito — passado diretamente ao comando
2. Flag --project — opcao global para todos os comandos
3. Descoberta automatica — escaneia o diretorio atual em busca de um arquivo .icp

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

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

# 3. Descoberta automatica (execute a partir do diretorio contendo o .icp)
cd my-project/
bobcorn icon list

Por padrao, o CLI produz texto legivel. Adicione --json para saida JSON estruturada, ideal para scripts e integracao com agentes de IA.

Estrutura do envelope JSON

Toda resposta JSON segue um envelope consistente:

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

Tres estados de resposta

Criar, inspecionar e configurar arquivos de projeto .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, renomear, mover, copiar, excluir e configurar icones. Todas as referencias usam UUID — use icon list --json para descobrir 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>

Organize icones em grupos nomeados. Grupos controlam a ordem de exibicao na barra lateral e podem ser usados para filtrar exportacoes.

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>

Gere arquivos de fonte e exporte SVGs. Suporta SVG, TTF, WOFF, WOFF2 e EOT com arquivos CSS e JS opcionais.

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

Busque icones por nome e gerencie favoritos marcados.

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

Gerencie variantes de peso e escala de icones (estilo SF Symbols). A geracao de variantes requer o GUI do Bobcorn, mas voce pode listar e excluir variantes pelo CLI.

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

O CLI do Bobcorn foi projetado para funcionar perfeitamente com agentes de codificacao de IA como Claude Code, Codex, Cursor e outros. Use --json para saida estruturada que os agentes possam analisar com seguranca.

Principios-chave

• Todo comando suporta --json para saida legivel por maquina
• O envelope JSON e consistente em todos os comandos — agentes podem confiar na estrutura ok / error / data
• A descoberta automatica permite que agentes simplesmente facam cd para o diretorio do projeto e executem comandos sem especificar caminhos
• Codigos de erro sao previsiveis: ICON_NOT_FOUND, GROUP_NOT_FOUND, FILE_IO_ERROR, etc.

Exemplo de fluxo de trabalho do 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 esta um script bash completo de ponta a ponta mostrando um fluxo de trabalho 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 "Pronto! Os arquivos de fonte estao em ./src/fonts"