Úvod

Co je PRECC?

PRECC (Prediktivní korekce chyb pro Claude Code) je nástroj v Rustu, který zachycuje bash příkazy Claude Code prostřednictvím oficiálního mechanismu PreToolUse hook. Opravuje chyby dříve, než nastanou, šetří tokeny a odstraňuje smyčky opakovaných pokusů.

Zdarma pro uživatele komunity.

Problém

Claude Code plýtvá značným množstvím tokenů na chyby, kterým lze předejít:

• Chyby špatného adresáře – Spuštění cargo build v nadřazeném adresáři, který nemá Cargo.toml, a opakovaný pokus po přečtení chyby.
• Smyčky opakování – Neúspěšný příkaz vytvoří podrobný výstup, Claude jej čte, analyzuje a opakuje. Každý cyklus spotřebuje stovky tokenů.
• Podrobný výstup – Příkazy jako find nebo ls -R vypisují tisíce řádků, které musí Claude zpracovat.

Čtyři pilíře

Korekce kontextu (cd-prepend)

Detekuje, když příkazy jako cargo build nebo npm test běží ve špatném adresáři a předřadí cd /correct/path && před spuštění.

Ladění GDB

Detekuje příležitosti pro připojení GDB k hlubšímu ladění segfaultů a pádů a poskytuje strukturované ladicí informace místo surových výpisů paměti.

Těžba sezení

Těží záznamy sezení Claude Code pro páry chyba-oprava. Když se stejná chyba opakuje, PRECC již zná opravu a aplikuje ji automaticky.

Automatizační dovednosti

Knihovna vestavěných a vytěžených dovedností, které odpovídají vzorům příkazů a přepisují je. Dovednosti jsou definovány jako TOML soubory nebo řádky SQLite, takže je lze snadno prohlížet, upravovat a sdílet.

Jak to funguje (30sekundová verze)

1. Claude Code se chystá spustit bash příkaz.
2. PreToolUse hook odešle příkaz do precc-hook jako JSON přes stdin.
3. precc-hook zpracuje příkaz pipelinou (dovednosti, korekce adresáře, komprese) za méně než 3 milisekundy.
4. Opravený příkaz je vrácen jako JSON přes stdout.
5. Claude Code místo toho spustí opravený příkaz.

Triviální chyby se sloučí; důvod přepisu je součástí odpovědi hooku, takže každou korekci lze auditovat — není tichá.

Bezpečnostní hranice

PRECC přepisuje pouze tehdy, když je sémantická ekvivalence prokazatelně zachována nebo uživatelem ověřitelná. Destruktivní příkazy (rm, git push --force, git reset --hard) se nikdy nepřepisují, ani když se dovednost shoduje. Každá mutace musí být ohraničená — přepsaný příkaz musí stále obsahovat klíčové tokeny originálu. Neohraničené přepisy se automaticky vrátí. Každý aplikovaný přepis se zaznamenává a zobrazuje, abyste jej mohli auditovat, zakázat nebo vrátit zpět.

Adaptivní komprese

Pokud příkaz selže po kompresi, PRECC automaticky přeskočí kompresi při opakování, aby Claude dostal plný nekomprimovaný výstup pro ladění.

Živá statistika použití

Aktuální verze –:

Measured Savings (Ground Truth)

Úspory podle verze

Tato čísla se automaticky aktualizují z anonymizované telemetrie.

Odkazy

• GitHub: https://github.com/peria-ai/precc-cc
• Web: https://peria.ai
• Dokumentace: https://precc.cc