@fazer-ai/agents

CLI de bootstrap do onboarding da fazer.ai agents. Roda no PC do usuário, agnóstico de SO (via bunx/npx), e prepara o seu agente de IA para conduzir a jornada de onboarding ponta a ponta.

O que faz

bunx @fazer-ai/agents@latest (ou npx @fazer-ai/agents@latest):

1. Escolhe o agente: Hermes, Claude Code, Codex ou "outro" (genérico). Sem --agent, o CLI pergunta; a última escolha vira o default ("último usado").
2. Autentica na fazer.ai: login OAuth no browser por padrão, com a sessão reaproveitada nas próximas vezes (~/.fazer-ai/oauth.json); --login força um login novo.
3. Instala o agente se faltar (instalador oficial de cada um) e confere o login.
4. Define a edição do Chatwoot (licença do Kanban): lista as suas licenças do hub: uma livre → Pro (com Kanban); uma já atribuída → alerta pra desvincular; nenhuma disponível → adquirir (app.fazer.ai?cart=1) ou seguir em OSS; lista vazia → a comunidade do Lucas Moreira (licença grátis) ou OSS. A escolha vira o marcador ~/.fazer-ai/onboarding.json que a skill lê no deploy.
5. Conecta as ferramentas (MCP): os conectores da Hostinger (DNS, VPS, domínio) quando o provider é Hostinger. O MCP da fazer.ai agents é conectado depois, pelo próprio agente, após o deploy.
6. Instala o guia de onboarding: a skill agents-onboarding a partir do marketplace fazer.ai.
7. Faz o handoff: abre o agente já na jornada, com o prompt inicial semeado.

Os agentes automatizados (Hermes/Claude/Codex) executam tudo de ponta a ponta. O "outro" não automatiza: imprime os passos e o prompt para você levar ao agente que for usar.

Uso

bunx @fazer-ai/agents@latest [opções]
npx  @fazer-ai/agents@latest [opções]

| Opção | Para quê | | ----------------- | ------------------------------------------------------------------ | | --agent <id> | hermes, claude, codex ou other. Sem isto, o CLI pergunta. | | --provider <id> | Infra de VPS/DNS: hostinger (default) ou other. | | --login | Força um login novo no browser (ignora a sessão salva). | | --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) + diagnósticos. | | -V, --version | Versão do CLI. | | -h, --help | Ajuda. |

O provider hostinger injeta os MCPs de provisionamento; other não injeta (o agente instrui DNS/VPS com base no provider que você indicar).

Defina FAZER_AI_CLI_THEME=light para o tema claro (terminais de fundo branco); o padrão é o tema escuro. NO_COLOR desliga a cor por completo.

Plataformas

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

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

Estado em disco (~/.fazer-ai/, 0600)

O CLI guarda localmente, para reaproveitar entre execuções:

| Arquivo | Conteúdo | | ------------------ | ------------------------------------------------------------- | | oauth.json | Sessão OAuth da fazer.ai. | | hostinger.json | Token da API Hostinger (opt-in; reaproveitado nas próximas). | | onboarding.json | Marcador da jornada que a skill lê: chatwootTier (pro/community) + chatwootLicenseId. | | preferences.json | Últimas escolhas (agente, provider, licença) pra virar default. | | mcp/ | Conector da Hostinger instalado localmente (hostinger-api-mcp). |

O token da Hostinger é gravado no config de MCP do agente (a partir do hostinger.json), para o conector funcionar mesmo quando você reabrir o agente fora do handoff. Consequência: não versione nem compartilhe o config de MCP do agente (~/.codex/…, ~/.claude.json, config do Hermes), pois ele passa a conter o token. No preview (--dry-run) o token é sempre redigido.

Desenvolvimento

npm install
npm run build      # tsc -> dist/
node dist/index.js --help
npm test           # vitest

Uma única dependência de runtime (cross-spawn, para resolver os shims .cmd/.ps1 no Windows nativo); o resto é node:*. Excluído do Biome/tsconfig do app principal; tem o próprio tsconfig.json e suíte vitest.

Configuração (env)

| Variável | Default | Para quê | | ------------------------------- | ------------------------ | --------------------------------------------------- | | FAZER_AI_HUB_URL | https://app.fazer.ai | Base do hub (MCP, OAuth/licenças). | | HOSTINGER_API_TOKEN | (nenhum) | Token da API Hostinger (senão o CLI pede/usa cache).| | AGENTS_PROVIDER | hostinger | Provider de infra (equivale a --provider). | | AGENTS_MARKETPLACE_TARGET | fazer-ai/agents-skills | Repo do plugin marketplace add (Claude/Codex). | | AGENTS_MARKETPLACE_NAME | agents | Nome sob o qual o marketplace é registrado. | | AGENTS_HERMES_TAP_REPO | fazer-ai/agents-skills | Repo do hermes skills tap add. | | AGENTS_HERMES_SKILL_REF | fazer-ai/agents-skills/agents-onboarding | Ref do hermes skills install. | | AGENTS_PLUGIN | agents | Plugin/skill a instalar + handoff. | | AGENTS_OAUTH_CLIENT_ID | (nenhum) | client_id OAuth pré-registrado (se o hub não usar DCR).|