> ## Documentation Index
> Fetch the complete documentation index at: https://zeropath.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuração

> Configurações, credenciais e logs da integração com agentes de codificação

<h2 id="zeropath-config-env">
  `~/.zeropath/config.env`
</h2>

Lido pelos stop hooks a cada invocação; variáveis de ambiente reais têm
precedência sobre os valores do arquivo.

| Variável                               | Padrão                 | Significado                                                                                                                                                                                                                   |
| -------------------------------------- | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ZEROPATH_BLOCKING_STOP_HOOKS`         | `false`                | `true` faz o Stop hook do Claude Code bloquear o agente enquanto existirem achados no limiar ou acima dele, devolvendo os achados para remediação. (Os stop hooks do Cursor não podem bloquear em nenhuma hipótese.)          |
| `ZEROPATH_HOOK_SEVERITY_THRESHOLD`     | `high`                 | Severidade mínima que dispara o bloqueio: `critical`, `high`, `medium`, `low` ou `info`. Todos os achados são reportados e registrados em log de qualquer forma.                                                              |
| `ZEROPATH_HOOK_TIMEOUT_SECONDS`        | `240`                  | Quanto tempo um hook espera pela conclusão da varredura. Em caso de timeout, o hook segue a política de fail open (avisa, nunca bloqueia). Mantenha abaixo do timeout do hook registrado no agente (300s para o Claude Code). |
| `ZEROPATH_HOOK_MAX_BLOCKS_PER_SESSION` | `3`                    | Orçamento do modo de bloqueio por sessão do agente; evita loops infinitos de remediação quando o agente não consegue corrigir um achado.                                                                                      |
| `ZEROPATH_HOOKS_DISABLED`              | `false`                | `true` transforma os hooks em no-ops sem desinstalá-los.                                                                                                                                                                      |
| `ZEROPATH_BASE_URL`                    | `https://zeropath.com` | URL base da API para ambientes self-hosted / de branch.                                                                                                                                                                       |

<h2 id="credentials">
  Credenciais
</h2>

* `~/.config/zeropath/credentials.json` — gravado por `zeropath auth`, usado
  pela CLI e, portanto, pelos hooks.
* A configuração MCP de cada agente carrega o token nas variáveis de ambiente
  `ZEROPATH_TOKEN_ID` / `ZEROPATH_TOKEN_SECRET` (além das opcionais
  `ZEROPATH_ORG_ID`, `ZEROPATH_BASE_URL`).

Para rotacionar um token: execute o instalador novamente com
`--token-id/--token-secret` (ele regrava os dois lugares), ou execute
`zeropath auth NEW_ID NEW_SECRET` e atualize os blocos de configuração MCP
manualmente.

<h2 id="installer-environment-overrides">
  Sobrescritas de ambiente do instalador
</h2>

| Variável                          | Finalidade                                                                                                                                                                                              |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ZEROPATH_AGENT_INSTALL_RAW_BASE` | De onde o `install.sh` busca os arquivos de suporte (padrão: a URL raw do repositório [agent\_install](https://github.com/ZeroPathAI/agent_install) na `main`). Aponte para um branch/fork para testes. |
| `ZEROPATH_CLI_RELEASE_BASE`       | De onde o binário da CLI `zeropath` é baixado.                                                                                                                                                          |
| `ZEROPATH_MCP_SERVER_SOURCE`      | A origem do `uvx --from` para o servidor MCP (padrão: seu repositório no GitHub; fixe uma tag/commit para reprodutibilidade).                                                                           |
| `ZEROPATH_HOME`                   | Raiz da instalação (padrão `~/.zeropath`).                                                                                                                                                              |

<h2 id="logs-and-cache">
  Logs e cache
</h2>

* `~/.zeropath/logs/scan-<agent>-<timestamp>.json` — resultado completo da
  varredura (job enviado, status, vulnerabilidades, correções sugeridas) para
  cada varredura de hook, incluindo as que falharam.
* `~/.zeropath/cache/hook-state.json` — hash do diff por workspace (evita
  reescanear diffs inalterados) e orçamentos de bloqueio por sessão. Pode ser
  apagado com segurança.