Usando PRECC com o Cursor

O PRECC foi construído como um hook PreToolUse para o Claude Code, mas a biblioteca de skills subjacente — cargo-wrong-dir, git-wrong-dir, npm-wrong-dir, jj-translate e companhia — é independente do editor. Com um pequeno snippet de shell você pode rotear cada comando digitado no terminal integrado do Cursor através do precc-hook, de modo que as mesmas reescritas que economizam tokens no Claude Code também os economizem no Cursor.

Requires precc ≥ 0.3.45. Earlier versions don’t plant the integration scripts under <data_dir>/integrations/cursor/. Run precc update to upgrade if you have an older release.

O que é coberto

A integração captura comandos que você digita no terminal do Cursor. No zsh ela reescreve automaticamente a linha de comando antes do Enter; no bash ela só pode emitir um aviso (o trap DEBUG dispara depois que o comando é finalizado). Comandos que o agente do Cursor executa como subprocessos bash -c não carregam a inicialização do seu shell interativo, então o hook não os vê; fechar essa lacuna exige um shim de PATH, que ainda não está neste diretório. Chamadas de ferramentas do Cursor que não passam pelo shell (edições de arquivo, busca de código) também estão fora do escopo.

Instalação

zsh (reescrita automática)

source ~/.local/share/precc/integrations/cursor/precc-preexec.zsh

Execute precc init uma vez — ele instala o script no caminho acima (usa <data_dir> do armazenamento do precc, então CLAUDE_CONFIG_DIR e outros isolamentos de perfil são respeitados). Em seguida, adicione a linha source ao ~/.zshrc. precc-hook e jq precisam estar no PATH; o script não faz nada (sem erros) se algum deles estiver ausente.

bash (apenas aviso)

source ~/.local/share/precc/integrations/cursor/precc-preexec.bash

Execute precc init uma vez — ele instala o script no caminho acima. Em seguida, adicione a linha source ao ~/.bashrc. O trap DEBUG imprime a reescrita sugerida no stderr sem aplicá-la; você pode copiar a sugestão manualmente.

Verificar

No terminal do Cursor, faça cd /tmp (qualquer lugar fora de um projeto Rust) e digite um comando de build do Rust e então pressione Enter. No zsh o buffer deve mudar in-place para uma forma reescrita pelo PRECC (tipicamente um prepend no estilo cd PATH && …). No bash você deve ver uma linha [precc] suggested rewrite: … no stderr.

Ressalvas

• Adiciona a latência do precc-hook por tecla pressionada. O hook tem como alvo <5 ms p50, mas o p99 é maior com caches frios; veja as notas sobre latência do hook neste livro.
• Sem telemetria por este caminho. O hook reportará sob qualquer agent_class que detectar, que não será claude-code — suas economias no Cursor não aparecerão na página pública de estatísticas.
• O motivo da reescrita pisca via zle -M por um keystroke. Discreto, não modal.
• Para cobertura do agente, um shim de PATH (wrappers em ~/.precc/bin/cargo, ~/.precc/bin/git, …) é o próximo passo planejado.