O que o instalador grava
A regra de projeto (execute uma vez por projeto)
O Cursor carrega regras de agente de<project>/.cursor/rules/, e as “User
Rules” globais só são editáveis pela interface gráfica — então a regra precisa
ser instalada por projeto:
.cursor/rules/zeropath.mdc (alwaysApply: true), que instrui o
agente do Cursor a enviar seu diff para asyncCodeScans.submit com o contexto
da tarefa em additionalContext, e a corrigir achados críticos/altos antes de
declarar uma tarefa concluída. Faça commit do arquivo se quiser que toda a
equipe receba o comportamento.
Configuração manual do MCP
Em~/.cursor/mcp.json (ou no .cursor/mcp.json por projeto):
Ressalvas sobre o hook
Os hooks do Cursor (~/.cursor/hooks.json) são um recurso beta e seu evento
de stop não pode bloquear o agente — então, no Cursor, o stop hook é apenas de
monitoramento: ele escaneia o diff não commitado e grava o relatório em
~/.zeropath/logs/. A aplicação determinística no Cursor vem, portanto, da
regra de projeto + caminho MCP, e da varredura de PRs do ZeroPath mais adiante
no fluxo. Se a sua versão do Cursor for anterior ao suporte a hooks, a entrada
em hooks.json é simplesmente ignorada.
Verificar
- Settings → MCP:
zeropathlistado com suas ferramentas após um restart. - Peça ao agente para “escanear minhas alterações não commitadas com o
ZeroPath” e confirme que ele chama as ferramentas
asyncCodeScans.*. - Após uma sessão do agente que alterou código, verifique em
~/.zeropath/logs/se há um relatórioscan-cursor-stop-*.json.