oracle

• Du vill ställa en djup fråga till en stor AI-modell (GPT‑5.2 Pro, Gemini, Claude, osv.) om din kodbas och behöver att den ser de relevanta källfilerna, inte bara ett utdrag.
• Du behöver en "long think"-körning — uppgifter som tar 10 minuter till en timme — och vill ha en sparad session du kan återansluta till om CLI:t tar timeout.
• Du behöver exakt kontroll över vilka filer som paketeras (via globbar, exkluderingar och .gitignore-kännedom) för att hålla tokenutgifterna förutsägbara.
• Du vill förhandsgranska hela nyttolasten och tokenkostnaden med --dry-run innan du skickar något till en modell.

• Du behöver realtids-, flerstegs-konversationskontext över många fram-och-tillbaka-utbyten — oracle-körningar är engångskörningar; tidigare körningar minns inte utan att en sparad session återkopplas.
• Du vill använda en annan modell än GPT eller Gemini via webbläsarmotorn — de kräver --engine api (Claude, Grok, Codex, osv.).
• Dina kontextfiler överstiger 1 MB styck — oracle avvisar filer över den gränsen.

oracle slår samman din prompt med valfritt antal filer, kataloger eller glob-mönster till ett enda förfrågningsinnehåll. Skicka --file flera gånger, blanda inkluderingar och !-prefixade exkluderingar, och oracle hoppar automatiskt och intelligent över node_modules, dist, .git och andra bruskataloger.

Läget --engine browser styr ChatGPT eller Gemini direkt i en webbläsarsession — idealiskt för modeller som endast är tillgängliga via webbgränssnittet. Det avgör automatiskt om innehåll ska klistras in direkt eller laddas upp som bilaga baserat på storlek (upp till ~60 000 tecken direkt, därefter filuppladdning).

Alla körningar lagras under ~/.oracle/sessions. Om en lång webbläsarkörning kopplas från eller tar timeout, använd oracle status --hours 72 för att lista senaste sessioner och oracle session <id> --render för att återansluta — inget behov av att köra om och spendera tokens igen.

Kör --dry-run summary eller --dry-run full kombinerat med --files-report för att inspektera exakt vad som skulle skickas och uppskatta tokenkostnaden innan någon faktisk förfrågan görs. Detta förhindrar oväntade överskridanden på stora kodbaser.

När OPENAI_API_KEY är inställd (eller --engine api anges explicit) dirigerar oracle trafiken via API:et istället för webbläsaren. Detta låser upp Claude, Grok, Codex och arbetsflöden med flera modeller som webbläsarmotorn inte stöder.

Kör en webbläsarautomationsvärd på en fjärrdator med oracle serve --host 0.0.0.0 --port 9473 --token <secret>, och anslut sedan valfri oracle-klient till den. Användbart för att avlasta långvariga webbläsarsessioner till en server.

En utvecklare paketerar de relevanta src/**-filerna med en detaljerad prompt som beskriver buggen, feltexten och begränsningarna, och kör sedan oracle --engine browser --model gpt-5.2-pro. Modellen tar emot hela kontexten och returnerar en åtgärdsplan för patchen. Om sessionen kopplas från efter 20 minuter återansluter utvecklaren istället för att köra om kommandot.

Innan en dyr körning påbörjas kör en utvecklare oracle --dry-run summary --files-report -p "<task>" --file "src/**" för att se vilka filer som skulle inkluderas och hur många tokens de skulle förbruka, och trimmar sedan filuppsättningen innan den riktiga körningen.

När webbläsarmotorn inte är lämplig använder utvecklaren oracle --render --copy -p "<task>" --file "src/**" för att rendera den fullständiga, sammanslagna prompten till urklippet och klistrar sedan in den manuellt i valfritt chattgränssnitt.

För ett komplext felsökningsarbete som sträcker sig över flera dagar skriver en utvecklare en fristående promptfil med en projektbeskrivning på 6–30 meningar, reproduktionssteg och exakta felmeddelanden, och bifogar sedan alla relevanta konfigurations- och startpunktsfiler. Prompten är självständig så att samma oracle-kommando kan köras om dagar senare med identiskt sammanhang.