Skip to main content
@izapai/wizard é uma CLI voltada para desenvolvedores que adiciona a iZap a uma aplicação existente. Ela é orientada por receitas e determinística: detecta sua stack, grava edições pequenas e explícitas e scaffolds baseados em código-fonte, e mostra uma prévia de cada mudança antes de tocar em um arquivo. Nenhuma chave de API ou chamada de LLM é necessária.

​
Executando

Ou instale o binário globalmente:
Em um terminal, o comando puro abre um assistente em tela cheia com uma checklist de tarefas ao vivo e abas Status / Logs / Reference. Em um pipe ou CI, ele imprime os mesmos passos linha a linha — e sem um TTY, gravar exige --yes: caso contrário a execução mostra o plano e sai com código diferente de zero. --dry-run mostra a prévia sem gravar; --yes pula a etapa de confirmação. O assistente nunca sobrescreve um arquivo de scaffold que você editou: arquivos em conflito interrompem a execução com uma lista clara, e --force sobrescreve deliberadamente. Arquivos .env.example fazem merge por união (suas linhas prevalecem, chaves ausentes são adicionadas), e um .mcp.json malformado aborta em vez de ser substituído.

​
O que ele monta

Cliente MCP

Instala o servidor iZap MCP em .mcp.json, além de um cliente em TypeScript ou Python. Veja Analytics MCP.

Cliente REST

Scaffold de cliente JWT ou OAuth 2.0 + PKCE para TypeScript ou Python. Veja Autenticação.

Webhooks e SSE

Um receptor de webhook ou um cliente Server-Sent Events para streams de chat ao vivo.

Superfícies de WhatsApp

Templates, transmissões (broadcasts), envio de mensagens e uma página de conexão com Meta Embedded Signup — do lado do servidor, para que seu JWT nunca chegue ao navegador.

​
Comandos comuns

Flags compartilhadas: --dry-run, --json, --force, --output-dir DIR, --target-root PATH, --env production|staging.

​
Handoff para agentes

izap-wizard ai "<goal>" executa a mesma detecção e planejamento, e depois grava um izap-integration-brief.md que você pode entregar a um agente de código (Claude Code, Cursor ou um agente conectado via MCP):
O assistente nunca lê os valores do seu .env e nunca grava segredos. Ele prioriza gravações idempotentes e mostra as mudanças planejadas com --dry-run.