oracle

• Je wilt een groot AI-model (GPT‑5.2 Pro, Gemini, Claude, enz.) een diepgaande vraag stellen over je codebase en hebt het nodig dat het de relevante bronbestanden ziet, niet alleen een fragment.
• Je hebt een "long think"-run nodig — taken die 10 minuten tot een uur duren — en wilt een opgeslagen sessie waaraan je opnieuw kunt koppelen als de CLI een time-out krijgt.
• Je moet exact bepalen welke bestanden worden gebundeld (via globs, uitsluitingen en .gitignore-bewustzijn) om de tokenuitgaven voorspelbaar te houden.
• Je wilt de volledige payload en tokenkosten bekijken met --dry-run voordat je iets naar een model stuurt.

• Je hebt real-time, meerdere gespreksrondes nodig over veel heen-en-weeruitwisselingen — oracle-runs zijn eenmalig; eerdere runs worden niet onthouden zonder een opgeslagen sessie opnieuw te koppelen.
• Je wilt een ander model dan GPT of Gemini gebruiken via de browserengine — die vereisen --engine api (Claude, Grok, Codex, enz.).
• Je contextbestanden zijn elk groter dan 1 MB — oracle weigert bestanden boven die limiet.

oracle voegt je prompt samen met een willekeurig aantal bestanden, mappen of globs tot één enkel verzoek-payload. Geef --file meerdere keren mee, combineer includes en !-prefixed excludes, en oracle slaat automatisch node_modules, dist, .git en andere onnodige mappen slim over.

De modus --engine browser bestuurt ChatGPT of Gemini rechtstreeks in een browsersessie — ideaal voor modellen die alleen toegankelijk zijn via de webinterface. De engine bepaalt automatisch of inhoud inline wordt geplakt of als bijlage wordt geüpload, op basis van de grootte (tot ~60k tekens inline, daarna bestandsupload).

Alle runs worden opgeslagen onder ~/.oracle/sessions. Als een lange browsersessie wordt losgekoppeld of een time-out krijgt, gebruik dan oracle status --hours 72 om recente sessies te bekijken en oracle session <id> --render om opnieuw verbinding te maken — zonder de run opnieuw te starten en tokens te verspillen.

Voer --dry-run summary of --dry-run full uit in combinatie met --files-report om precies te inspecteren wat er verstuurd zou worden en de tokenkosten in te schatten voordat er een echte aanvraag wordt gedaan. Dit voorkomt onverwachte overschrijdingen bij grote codebases.

Wanneer OPENAI_API_KEY is ingesteld (of --engine api expliciet is opgegeven), stuurt oracle het verkeer via de API in plaats van de browser. Dit maakt Claude, Grok, Codex en multi-model workflows mogelijk die de browserengine niet ondersteunt.

Gebruik een browserautomatiseringshost op een externe machine met oracle serve --host 0.0.0.0 --port 9473 --token <secret>, en verbind vervolgens elke oracle-client ermee. Handig voor het uitbesteden van langlopende browsersessies aan een server.

Een ontwikkelaar bundelt de relevante src/**-bestanden met een gedetailleerde prompt die de bug, de foutmelding en de beperkingen beschrijft, en voert vervolgens oracle --engine browser --model gpt-5.2-pro uit. Het model ontvangt de volledige context en retourneert een patchplan. Als de sessie na 20 minuten wordt verbroken, koppelt de ontwikkelaar opnieuw aan in plaats van opnieuw te starten.

Voordat een ontwikkelaar zich vastlegt op een kostbare uitvoering, voert hij oracle --dry-run summary --files-report -p "<task>" --file "src/**" uit om te zien welke bestanden zouden worden opgenomen en hoeveel tokens ze zouden verbruiken. Vervolgens beperkt hij de bestandsset voordat de echte uitvoering plaatsvindt.

Wanneer de browserengine niet geschikt is, gebruikt de ontwikkelaar oracle --render --copy -p "<task>" --file "src/**" om de volledige gebundelde prompt naar het klembord te renderen en plakt deze vervolgens handmatig in een willekeurige chatinterface.

Voor een complexe foutopsporingsinspanning van meerdere dagen schrijft een ontwikkelaar een zelfstandig promptbestand met een projectbeschrijving van 6 tot 30 zinnen, reproductiestappen en exacte foutmeldingen, en voegt alle relevante configuratie- en toegangspuntbestanden bij. De prompt is op zichzelf staand, zodat dezelfde oracle-opdracht dagen later opnieuw kan worden uitgevoerd met een identieke context.