> ## Documentation Index > Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt > Use this file to discover all available pages before exploring further. # Failproof AI CLI > Instale hooks, gerencie políticas locais, conecte ao Cloud e opere o daemon local. Instale o CLI local com `npm install -g failproofai`. Execute sem argumentos para abrir o painel de políticas local. O pacote requer Node.js 20.9 ou superior. Bun 1.3 ou superior é suportado para desenvolvimento e instalações a partir do código-fonte. `failproofai configure` e `failproofai setup` são aliases de `failproofai config`; `failproofai p` é um alias de `failproofai policies`. ## Configurar uma máquina ```bash theme={null} npm install -g failproofai failproofai config \ --connect https://app.befailproof.ai \ --token \ --machine-label checkout-prod-01 failproofai policies --install failproofai config --status ``` Execute `failproofai` sem argumentos para abrir o painel de políticas local. | Comando | Resultado | | ------------------------------------------------------- | ----------------------------------------------------------------------------- | | `failproofai config` | Executa a configuração interativa da máquina | | `failproofai config --connect --token ` | Conecta a ingestão Cloud e a entrega de políticas | | `failproofai config --status` | Exibe o estado de conexão, daemon, entrega e pausa | | `failproofai policies` | Lista as políticas internas e personalizadas | | `failproofai policies --install` | Instala os hooks e ativa as políticas | | `failproofai policy add ` | Ativa uma política interna | | `failproofai policy remove ` | Desativa uma política interna | | `failproofai policies --uninstall` | Desativa políticas ou remove os hooks do harness | | `failproofai audit` | Escaneia o histórico local do agente e abre a visualização de auditoria local | | `failproofai audit --schedule [days] --email
` | Agenda varreduras locais recorrentes e envia os resultados por e-mail | | `failproofai audit --status` | Exibe o endereço de relatório, o intervalo e a próxima varredura agendada | | `failproofai audit --no-schedule` | Interrompe as varreduras recorrentes sem excluir o histórico de auditoria | | `failproofai harness list` | Lista os caminhos de captura adicionais | | `failproofai flush --wait` | Entrega o spool de eventos atual | | `failproofai backfill --since 30d` | Relê o histórico processado anteriormente | | `failproofai config --pause [duration]` | Pausa uma sessão local por 30 minutos por padrão, com limite de 8 horas | | `failproofai config --resume` | Retoma uma sessão local pausada; adicione `--all` para limpar todas as pausas | | `failproofai update` | Conclui as migrações do pacote e atualiza o daemon | | `failproofai migrate --dry-run` | Pré-visualiza ou executa as migrações pendentes do layout home | | `failproofai uninstall` | Remove os hooks e o daemon antes de remover o pacote | | `failproofai --version` | Exibe a versão do pacote instalado | | `failproofai --help` | Exibe os comandos e o uso global | ## Flags de configuração | Flag | Uso | | ------------------------------- | ------------------------------------------------------------------------------------------------------------ | | `--connect --token ` | Conecta sem interação | | `--machine-id ` | Define o ID estável da máquina | | `--machine-label ` | Define ou altera o rótulo no painel | | `--no-transcripts` | Envia decisões sem o conteúdo do transcript | | `--disconnect` | Interrompe os pulls de política e a entrega de eventos do Cloud | | `--status` | Exibe o estado atual da máquina | | `--pause [duration]` | Pausa a sessão mais recente no diretório atual; aceita segundos, minutos ou horas e tem padrão de 30 minutos | | `--resume` | Encerra antecipadamente uma pausa correspondente | | `--session ` | Direciona uma sessão específica para pausar ou retomar | | `--all` | Com `--resume`, encerra todas as pausas ativas | Pausas locais suspendem as políticas internas, personalizadas e de convenção para uma sessão. Elas sempre expiram e não desativam as políticas gerenciadas pelo Cloud. `block-self-pause` impede que um agente instrumentado utilize essa brecha por conta própria. ## Flags de política | Flag | Uso | | ----------------------------------- | ------------------------------------------------------------------ | | `--install`, `-i` | Ativa as políticas e instala os hooks do harness | | `--uninstall`, `-u` | Desativa as políticas ou remove os hooks | | `--cli ` | Direciona um ou mais harnesses suportados | | `--scope user\|project\|local\|all` | Escolhe o escopo de configuração; `all` é usado para desinstalação | | `--beta` | Inclui políticas beta | | `--custom`, `-c ` | Valida e carrega um arquivo de política personalizado; repetível | ## Flags de entrega e manutenção | Comando | Flags | | ----------- | -------------------------------------------- | | `backfill` | `--since <30d\|6m\|YYYY-MM-DD>`, `--dry-run` | | `flush` | `--wait`, `--timeout ` | | `update` | `--no-daemon` | | `migrate` | `--dry-run` | | `uninstall` | `--purge`, `--dry-run`, `--yes` | `failproofai update` deve ser executado após `npm install -g failproofai@latest`; ele realiza as migrações do layout home, instala o binário do daemon correspondente e reinicia o serviço. `--no-daemon` executa apenas a migração do layout. ## Caminhos do harness ```text theme={null} failproofai harness list [harness] failproofai harness add-path [label=] failproofai harness remove-path ``` Os nomes de harness suportados são `claude`, `codex`, `copilot`, `cursor`, `opencode`, `pi`, `hermes`, `openclaw`, `factory`, `devin`, `antigravity` e `goose`. Labels criam namespaces para IDs de agentes derivados quando duas raízes contêm cópias do mesmo projeto. Raízes sobrepostas e labels duplicados são rejeitados para evitar coleta duplicada ou corrupção de cursor. A configuração de caminhos extras é recarregada sem reiniciar o daemon. Ambientes de contêiner podem substituir os caminhos extras configurados em arquivo por uma variável separada por vírgulas chamada `FAILPROOFAI__EXTRA_PATHS`, por exemplo: ```bash theme={null} export FAILPROOFAI_OPENCLAW_EXTRA_PATHS="user1=/srv/openclaw-a,user2=/srv/openclaw-b" ``` ## Variáveis de ambiente Use arquivos de configuração para comportamento persistente da máquina. Variáveis de ambiente são mais úteis para contêineres, testes e processos únicos. | Variável | Uso | | ------------------------------------ | ----------------------------------------------------------------------- | | `FAILPROOFAI_HOME` | Reposiciona o layout completo do `~/.failproofai` | | `FAILPROOFAI_LOG_LEVEL` | Define o nível de verbosidade do log local | | `FAILPROOFAI_HOOK_LOG_FILE` | Grava diagnósticos do hook em um arquivo específico | | `FAILPROOFAI_TELEMETRY_DISABLED=1` | Desativa a telemetria anônima para este processo | | `FAILPROOFAI_NO_FIRST_RUN=1` | Ignora a configuração interativa de primeira execução | | `FAILPROOFAI_NO_AUTO_AUDIT=1` | Ignora a auditoria local pós-configuração | | `FAILPROOFAI_LLM_BASE_URL` | Substitui o endpoint compatível com OpenAI usado pelas políticas de LLM | | `FAILPROOFAI_LLM_API_KEY` | Fornece a chave de API usada pelas políticas de LLM | | `FAILPROOFAI_LLM_MODEL` | Seleciona o modelo usado pelas políticas de LLM | | `FAILPROOFAI_POLICY_LOAD_TIMEOUT_MS` | Limita o tempo de carregamento do módulo de política personalizado | | `FAILPROOFAI__EXTRA_PATHS` | Substitui os caminhos de captura extras configurados para um harness | | `NO_COLOR` | Desativa a saída colorida no terminal | Variáveis home específicas de agente, como `CLAUDE_PROJECTS_PATH`, `CURSOR_HOME`, `HERMES_HOME` e `OPENCLAW_HOME`, substituem o local onde o Failproof AI descobre sessões locais para aquele harness. ## Pausar ou remover uma máquina com segurança ```bash theme={null} failproofai config --pause failproofai config --status failproofai config --resume ``` Uma pausa de sessão local não desativa as políticas gerenciadas pelo Cloud. Restaure as implantações Cloud pelo fluxo de trabalho de enforcement do Cloud quando o próprio rollout for o problema. Antes de remover o pacote npm, remova os hooks instalados e o daemon: ```bash theme={null} failproofai uninstall --dry-run failproofai uninstall --yes npm rm -g failproofai ``` Execute `failproofai --help` para detalhes específicos da versão. Execute `failproofai uninstall` antes de `npm rm -g failproofai`; o npm não remove os hooks de agente instalados nem o serviço daemon.