Inleiding

Wat is PRECC?

PRECC (Voorspellende foutcorrectie voor Claude Code) is een Rust-tool die Claude Code bash-commando’s onderschept via het officiële PreToolUse hook-mechanisme. Het herstelt fouten voordat ze gebeuren, bespaart tokens en elimineert herstartlussen.

Gratis voor community-gebruikers.

Het probleem

Claude Code verspilt aanzienlijke tokens aan vermijdbare fouten:

• Verkeerde-mapfouten – cargo build uitvoeren in een bovenliggende map zonder Cargo.toml, en opnieuw proberen na het lezen van de fout.
• Herhaalpogingen – Een mislukt commando produceert uitgebreide uitvoer, Claude leest het, redeneert erover en probeert opnieuw. Elke cyclus verbrandt honderden tokens.
• Uitgebreide uitvoer – Commando’s zoals find of ls -R produceren duizenden regels die Claude moet verwerken.

De vier pijlers

Contextcorrectie (cd-prepend)

Detecteert wanneer commando’s zoals cargo build of npm test in de verkeerde directory worden uitgevoerd en voegt cd /juist/pad && toe voor uitvoering.

GDB-debugging

Detecteert mogelijkheden om GDB aan te koppelen voor diepere debugging van segfaults en crashes en biedt gestructureerde debuginformatie in plaats van ruwe core dumps.

Sessie-mining

Mijnt Claude Code sessielogs op fout-fix-paren. Wanneer dezelfde fout terugkeert, kent PRECC de oplossing al en past deze automatisch toe.

Automatiseringsvaardigheden

Een bibliotheek van ingebouwde en gemijnde vaardigheden die overeenkomen met commandopatronen en deze herschrijven. Vaardigheden zijn gedefinieerd als TOML-bestanden of SQLite-rijen, waardoor ze gemakkelijk te inspecteren, bewerken en delen zijn.

Hoe het werkt (30-seconden versie)

1. Claude Code staat op het punt een bash-commando uit te voeren.
2. De PreToolUse hook stuurt het commando als JSON via stdin naar precc-hook.
3. precc-hook voert het commando uit via de pijplijn (vaardigheden, mapcorrectie, compressie) in minder dan 3 milliseconden.
4. Het gecorrigeerde commando wordt als JSON via stdout teruggestuurd.
5. Claude Code voert het gecorrigeerde commando uit in plaats van het origineel.

Triviale fouten worden samengevoegd; de reden van de herschrijving reist mee in het hook-antwoord, zodat elke correctie controleerbaar is — niet stilzwijgend.

Veiligheidsgrens

PRECC herschrijft alleen wanneer semantische equivalentie bewijsbaar behouden blijft of door de gebruiker verifieerbaar is. Destructieve commando’s (rm, git push --force, git reset --hard) worden nooit herschreven, zelfs als een vaardigheid overeenkomt. Elke mutatie moet begrensd zijn — het herschreven commando moet de kerntokens van het origineel bevatten. Onbegrensde herschrijvingen worden automatisch teruggedraaid. Elke toegepaste herschrijving wordt gelogd en getoond zodat u kunt controleren, uitschakelen of ongedaan maken.

Adaptieve compressie

Als een commando faalt na compressie, slaat PRECC automatisch compressie over bij de volgende poging zodat Claude de volledige ongecomprimeerde uitvoer krijgt om te debuggen.

Live gebruiksstatistieken

Huidige versie –:

Measured Savings (Ground Truth)

Besparingen per versie

Deze cijfers worden automatisch bijgewerkt vanuit geanonimiseerde telemetrie.

Links

• GitHub: https://github.com/peria-ai/precc-cc
• Website: https://peria.ai
• Documentatie: https://precc.cc