@indicafacil/agents

CLI de bootstrap do onboarding do Indica Fácil Agents. Roda no PC do usuário, agnóstico de SO (via bunx/npx), e prepara o agente de IA dele para conduzir a jornada de onboarding ponta a ponta.

O que faz

npx @indicafacil/agents@latest — normalmente invocado pelo instalador:

curl -fsSL https://agents.indicafacil.ai/install.sh | bash

irm https://agents.indicafacil.ai/install.ps1 | iex

Três fases:

1. Escolhe o agente de IA: Claude Code, Codex ou "outro" (genérico). Sem --agent, o CLI pergunta; a última escolha vira o default. Instala o agente se faltar, com o instalador oficial de cada um.
2. Escolhe o provedor de infra: Hostinger (injeta os conectores MCP de DNS, VPS e domínio) ou outro (não injeta — o agente instrui DNS/VPS a partir do provider que o usuário indicar).
3. Prepara e entrega: conecta os MCPs, instala/atualiza a skill de onboarding a partir do marketplace, e abre o agente já dentro da jornada, com o prompt inicial semeado.

Não há fase de licença. O projeto de que este CLI deriva tinha uma quarta fase de login num hub central para escolher licença de Kanban; não temos hub, e o Kanban é nosso.

Uso

npx @indicafacil/agents@latest [opções]

| Opção | Para quê | | --- | --- | | --agent <id> | claude, codex ou other. Sem isto, o CLI pergunta. | | --provider <id> | Infra de VPS/DNS: hostinger (default) ou other. | | --dry-run | Só mostra o que faria, sem executar. | | -y, --yes | Executa sem confirmação interativa. | | --no-handoff | Prepara tudo, mas não abre o agente ao final. | | -v, --verbose | Mostra a saída dos comandos (normalmente silenciada). | | -V, --version | Versão do CLI. | | -h, --help | Ajuda. |

NO_COLOR desliga a cor.

Plataformas

Linux, macOS, Windows nativo (PowerShell/cmd) e WSL. Pré-requisito: Node ≥ 18 (ou Bun, via bunx).

No Windows nativo o CLI resolve os shims dos CLIs instalados via npm (claude.cmd, npm.ps1, …) e usa o instalador PowerShell oficial de cada agente. Use um terminal moderno (Windows Terminal) para a UI interativa de setas/Enter.

Estado em disco (~/.indica-facil/, 0700)

| Arquivo | Conteúdo | | --- | --- | | onboarding.json | Marcador da jornada que a skill lê (origem/edição do Chatwoot, edição do agents). | | hostinger.json | Token da API Hostinger (opt-in, 0600; reaproveitado nas próximas execuções). | | preferences.json | Últimas escolhas (agente, provider), para virar default. | | mcp/ | Conector da Hostinger instalado localmente. |

⚠️ O token da Hostinger é gravado no config de MCP do agente, para o conector funcionar quando você reabrir o agente fora do handoff. Consequência: não versione nem compartilhe o config de MCP do seu agente. No --dry-run o token é sempre redigido.

Configuração (env)

| Variável | Default | Para quê | | --- | --- | --- | | HOSTINGER_API_TOKEN | — | Token da API Hostinger (senão o CLI pede/usa o cache). | | AGENTS_PROVIDER | hostinger | Provider de infra (equivale a --provider). | | AGENTS_MARKETPLACE_TARGET | indicafacil-ai/agents-skills | Repo do plugin marketplace add. | | AGENTS_MARKETPLACE_NAME | agents | Nome sob o qual o marketplace é registrado. | | AGENTS_PLUGIN | agents | Plugin a instalar + handoff. | | AGENTS_SKILL | agents-onboarding | Skill invocada no handoff. | | AGENTS_HERMES_TAP_REPO | indicafacil-ai/agents-skills | Repo do tap do Hermes. |

Desenvolvimento

bun install
bun run build          # tsc → dist/ + embute as skills
node dist/index.js --help
node dist/index.js --dry-run --agent claude

Licença e origem

MIT. Obra derivada do CLI de onboarding do fazer.ai agents (MIT). Não somos afiliados à FAZER.AI LTDA.