oracle

Oracle to narzędzie CLI, które łączy Twój prompt z wybranymi plikami z repozytorium w jedną zwartą wiadomość. Wysyłasz ją do modelu AI (np. GPT-5.2 Pro) przez przeglądarkę lub API, a otrzymujesz odpowiedź opartą na rzeczywistym kodzie. Zanim uruchomisz pełne zapytanie, możesz podejrzeć, ile tokenów będzie kosztować, i wybrać tylko najpotrzebniejsze pliki. Jeśli sesja się przerwanie, możesz się do niej ponownie przyłączyć bez powtarzania całej operacji.

1. Zainstaluj oracle za pomocą npm: uruchom npx -y @steipete/oracle --help (unikaj pnpx ze względu na zależności sqlite). Jeśli chcesz stałą instalację, zainstaluj pakiet @steipete/oracle globalnie lub lokalnie w projekcie.

2. Przygotuj zestaw plików, które chcesz przesłać do modelu. Wybierz tylko te, które zawierają istotne informacje — im mniej plików, tym lepiej. Na przykład: src/** dla kodu źródłowego, ale wyklucz testy za pomocą !**/*.test.*.

3. Przed wysłaniem zapytania sprawdź koszt tokenów: uruchom oracle --dry-run summary --files-report -p "Twoje pytanie" --file "src/**". To pokaże Ci, ile tokenów będzie potrzebnych, bez faktycznego wysłania danych.

4. Uruchom oracle w trybie przeglądarki (główna ścieżka): oracle --engine browser --model gpt-5.2-pro -p "Twoje pytanie" --file "src/**". Sesja może trwać od 10 minut do godziny — to normalne. Model będzie miał dostęp do kontekstu Twoich plików.

5. Jeśli sesja się przerwanie lub timeout, możesz się do niej ponownie przyłączyć zamiast uruchamiać zapytanie od nowa. Nie polegaj całkowicie na odpowiedzi — zawsze zweryfikuj wynik względem rzeczywistego kodu i testów.