Failproof AI CLI

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 mais recente. Bun 1.3 ou mais recente é compatível 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

npm install -g failproofai
failproofai config \
  --connect https://app.befailproof.ai \
  --token <machine-key> \
  --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`	Executar a configuração interativa da máquina
`failproofai config --connect <url> --token <key>`	Conectar a ingestão e a entrega de políticas do Cloud
`failproofai config --status`	Exibir estado de conexão, daemon, entrega e pausa
`failproofai policies`	Listar políticas integradas, personalizadas, de convenção, de pack e gerenciadas pelo Cloud
`failproofai policies --install`	Instalar hooks e habilitar políticas
`failproofai policy add <name>`	Habilitar uma política — integrada, ou `<pack-id>:<name>` de um pack instalado
`failproofai policy remove <name>`	Desabilitar uma política, mesma nomenclatura
`failproofai policies --uninstall`	Desabilitar políticas ou remover os hooks do harness
`failproofai pack list`	Listar packs de políticas instalados e todas as políticas que cada um contém
`failproofai pack add <source>`	Instalar um pack de políticas a partir de uma release do GitHub; sem tag, usa a mais recente e a fixa
`failproofai pack add --bundled`	Instalar as políticas integradas como um pack, a partir deste pacote, sem necessidade de rede
`failproofai pack build <entry.mjs>`	Compilar os três artefatos de release para um pack próprio
`failproofai pack remove <publisher/name>`	Desativar um pack instalado
`failproofai audit`	Escanear o histórico local do agente e abrir a visualização de auditoria local
`failproofai audit --schedule [days] --email <address>`	Agendar varreduras locais recorrentes e enviar os resultados por e-mail
`failproofai audit --status`	Exibir o endereço do relatório, o intervalo e a próxima varredura agendada
`failproofai audit --no-schedule`	Interromper varreduras recorrentes sem excluir o histórico de auditoria
`failproofai harness list`	Listar caminhos de captura adicionais
`failproofai flush --wait`	Entregar o spool de eventos atual
`failproofai backfill --since 30d`	Reler o histórico processado anteriormente
`failproofai config --pause [duration]`	Pausar uma sessão local por 30 minutos por padrão, por até 8 horas
`failproofai config --resume`	Retomar uma sessão local pausada; adicione `--all` para limpar todas as pausas
`failproofai update`	Concluir migrações do pacote e atualizar o daemon
`failproofai migrate --dry-run`	Visualizar ou executar migrações de layout pendentes no diretório home
`failproofai uninstall`	Remover hooks e o daemon antes de desinstalar o pacote
`failproofai --version`	Exibir a versão do pacote instalado
`failproofai --help`	Mostrar comandos e uso global

Flags de configuração

Flag	Uso
`--connect <url> --token <key>`	Conectar de forma não interativa
`--machine-id <id>`	Definir o ID estável da máquina
`--machine-label <name>`	Definir ou alterar o rótulo do painel
`--no-transcripts`	Enviar decisões sem o conteúdo da transcrição
`--disconnect`	Interromper as atualizações de políticas e a entrega de eventos do Cloud
`--status`	Exibir o estado atual da máquina
`--pause [duration]`	Pausar a sessão mais recente no diretório atual; aceita segundos, minutos ou horas e tem como padrão 30 minutos
`--resume`	Encerrar uma pausa correspondente antecipadamente
`--session <id>`	Especificar uma sessão explícita para pausar ou retomar
`--all`	Com `--resume`, encerrar todas as pausas ativas

Pausas locais suspendem políticas integradas, personalizadas, de convenção e de pack para uma sessão. Elas sempre expiram e não desabilitam políticas gerenciadas pelo Cloud. block-failproofai-commands — que está sempre ativo e não pode ser desabilitado ou pausado — impede que um agente instrumentado use este mecanismo de escape por conta própria.

Flags de políticas

Flag	Uso
`--install`, `-i`	Habilitar políticas e instalar hooks do harness
`--uninstall`, `-u`	Desabilitar políticas ou remover hooks
`--cli <names...>`	Especificar um ou mais harnesses compatíveis
`--scope user\|project\|local\|all`	Escolher o escopo de configuração; `all` é para desinstalação
`--beta`	Incluir políticas beta
`--custom`, `-c <path>`	Validar e carregar um arquivo de política personalizado; pode ser repetido

Flags de entrega e manutenção

Comando	Flags
`backfill`	`--since <30d\|6m\|YYYY-MM-DD>`, `--dry-run`
`flush`	`--wait`, `--timeout <seconds>`
`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 migrações de layout do diretório home, instala o binário do daemon correspondente e reinicia o serviço. --no-daemon executa apenas a migração de layout.

Caminhos do harness

failproofai harness list [harness]
failproofai harness add-path <harness> [label=]<path>
failproofai harness remove-path <harness> <path-or-label>

Os nomes de harness compatíveis são claude, codex, copilot, cursor, opencode, pi, hermes, openclaw, factory, devin, antigravity e goose. Rótulos criam namespaces para IDs de agentes derivados quando duas raízes contêm cópias do mesmo projeto. Raízes sobrepostas e rótulos 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_<HARNESS>_EXTRA_PATHS, por exemplo:

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`	Realocar o layout completo de `~/.failproofai`
`FAILPROOFAI_LOG_LEVEL`	Definir a verbosidade do log local
`FAILPROOFAI_HOOK_LOG_FILE`	Gravar diagnósticos de hook em um arquivo específico
`FAILPROOFAI_TELEMETRY_DISABLED=1`	Desabilitar telemetria anônima para este processo
`FAILPROOFAI_NO_FIRST_RUN=1`	Ignorar a configuração interativa de primeira execução
`FAILPROOFAI_NO_AUTO_AUDIT=1`	Ignorar a auditoria local pós-configuração
`FAILPROOFAI_LLM_BASE_URL`	Substituir o endpoint compatível com OpenAI usado pelas políticas de LLM
`FAILPROOFAI_LLM_API_KEY`	Fornecer a chave de API usada pelas políticas de LLM
`FAILPROOFAI_LLM_MODEL`	Selecionar o modelo usado pelas políticas de LLM
`FAILPROOFAI_POLICY_LOAD_TIMEOUT_MS`	Limitar o tempo de carregamento de módulos de políticas personalizadas
`FAILPROOFAI_NO_DOWNLOAD=1`	Recusar o download de packs e binários do daemon; o que está instalado continua sendo aplicado
`FAILPROOFAI_PACK_BASE_URL`	Buscar packs de um espelho em vez de `github.com`
`FAILPROOFAI_<HARNESS>_EXTRA_PATHS`	Substituir os caminhos de captura extras configurados para um harness
`NO_COLOR`	Desabilitar a saída colorida no terminal

Variáveis home específicas de agentes, como CLAUDE_PROJECTS_PATH, CURSOR_HOME, HERMES_HOME e OPENCLAW_HOME, substituem onde o Failproof AI descobre sessões locais para aquele harness.

Pausar ou remover uma máquina com segurança

failproofai config --pause
failproofai config --status
failproofai config --resume

Uma pausa de sessão local não desabilita políticas gerenciadas pelo Cloud. Restaure implantações do Cloud por meio do fluxo de trabalho de aplicação do Cloud quando o próprio rollout for o problema. Antes de remover o pacote npm, remova os hooks instalados e o daemon:

failproofai uninstall --dry-run
failproofai uninstall --yes
npm rm -g failproofai

Execute failproofai <command> --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.

Connect your agents

Reference

Configurar uma máquina

Flags de configuração

Flags de políticas

Flags de entrega e manutenção

Caminhos do harness

Variáveis de ambiente

Pausar ou remover uma máquina com segurança

​Configurar uma máquina

​Flags de configuração

​Flags de políticas

​Flags de entrega e manutenção

​Caminhos do harness

​Variáveis de ambiente

​Pausar ou remover uma máquina com segurança

Configurar uma máquina

Flags de configuração

Flags de políticas

Flags de entrega e manutenção

Caminhos do harness

Variáveis de ambiente

Pausar ou remover uma máquina com segurança