Wprowadzenie

Czym jest PRECC?

PRECC (Predictive Error Correction for Claude Code) to narzędzie Rust, które przechwytuje polecenia bash Claude Code za pomocą oficjalnego mechanizmu hooków PreToolUse. Naprawia błędy zanim się pojawią, oszczędzając tokeny i eliminując pętle ponawiania.

Free for community users.

Problem

Claude Code marnuje znaczną liczbę tokenów na możliwe do uniknięcia błędy:

• Błędy katalogu – Uruchomienie cargo build w katalogu nadrzędnym bez Cargo.toml, a następnie ponowna próba po przeczytaniu błędu.
• Pętle ponawiania – Nieudane polecenie generuje szczegółowe wyjście, Claude je czyta, analizuje i ponawia próbę.
• Szczegółowe wyjście – Polecenia takie jak find lub ls -R generują tysiące linii, które Claude musi przetworzyć.

Cztery filary

Context Fix (cd-prepend)

Detects when commands like cargo build or npm test run in the wrong directory and prepends cd /correct/path && before execution.

Debugowanie GDB

Wykrywa możliwości podpięcia GDB do głębszego debugowania segfaultów i awarii, dostarczając ustrukturyzowane informacje debugowania.

Eksploracja sesji

Przeszukuje logi sesji Claude Code w poszukiwaniu par awaria-naprawa. Gdy ten sam błąd się powtarza, PRECC już zna poprawkę i stosuje ją automatycznie.

Umiejętności automatyzacji

Biblioteka wbudowanych i wydobytych umiejętności dopasowujących wzorce poleceń i je przepisujących. Umiejętności definiowane są jako pliki TOML lub wiersze SQLite.

Jak to działa (wersja 30-sekundowa)

1. Claude Code zamierza uruchomić polecenie bash.
2. Hook PreToolUse wysyła polecenie do precc-hook jako JSON na stdin.
3. precc-hook przetwarza polecenie przez potok (umiejętności, korekta katalogu, kompresja) w mniej niż 3 milisekundy.
4. Poprawione polecenie jest zwracane jako JSON na stdout.
5. Claude Code wykonuje poprawione polecenie.

Claude nigdy nie widzi błędu. Żadne tokeny nie są marnowane.

Kompresja adaptacyjna

If a command fails after compression, PRECC automatically skips compression on the retry so Claude gets the full uncompressed output to debug with.

Statystyki użycia na żywo

Figures are estimates. Each prevented failure avoids a full retry cycle: error output, model reasoning, and retry command. Te liczby aktualizują się automatycznie z zanonimizowanej telemetrii.

Linki

• GitHub: https://github.com/peria-ai/precc-cc
• Strona: https://peria.ai
• Dokumentacja: https://precc.cc