oracle

• Du möchtest einem großen KI-Modell (GPT‑5.2 Pro, Gemini, Claude usw.) eine tiefgehende Frage zu deiner Codebasis stellen und benötigst, dass es die relevanten Quelldateien sieht – nicht nur einen Ausschnitt.
• Du benötigst einen „Long Think"-Durchlauf – Aufgaben, die 10 Minuten bis zu einer Stunde dauern – und möchtest eine gespeicherte Sitzung, an die du dich wieder anhängen kannst, falls die CLI eine Zeitüberschreitung hat.
• Du musst genau steuern, welche Dateien gebündelt werden (über Globs, Ausschlüsse und .gitignore-Unterstützung), um die Token-Kosten kalkulierbar zu halten.
• Du möchtest die vollständige Nutzlast und die Token-Kosten mit --dry-run in der Vorschau prüfen, bevor du etwas an ein Modell sendest.

• Sie benötigen echten Echtzeit-Gesprächskontext über viele aufeinanderfolgende Austausche hinweg — oracle-Läufe sind einmalig; frühere Läufe werden nicht gespeichert, ohne eine gespeicherte Sitzung erneut anzuhängen.
• Sie möchten ein anderes Modell als GPT oder Gemini über die Browser-Engine verwenden — dafür ist --engine api erforderlich (Claude, Grok, Codex usw.).
• Ihre Kontextdateien überschreiten jeweils 1 MB — oracle lehnt Dateien ab, die dieses Limit überschreiten.

oracle fügt deinen Prompt mit beliebig vielen Dateien, Verzeichnissen oder Globs zu einem einzigen Anfrage-Payload zusammen. Übergib --file mehrmals, kombiniere Einschlüsse und mit ! vorangestellte Ausschlüsse, und oracle überspringt automatisch node_modules, dist, .git und andere störende Verzeichnisse.

Der Modus --engine browser steuert ChatGPT oder Gemini direkt in einer Browser-Sitzung – ideal für Modelle, die nur über die Web-Oberfläche zugänglich sind. Er entscheidet automatisch, ob Inhalte direkt eingefügt oder als Anhänge hochgeladen werden, basierend auf der Größe (bis zu ~60.000 Zeichen direkt, danach Datei-Upload).

Alle Ausführungen werden unter ~/.oracle/sessions gespeichert. Wenn eine lange Browser-Ausführung getrennt wird oder eine Zeitüberschreitung auftritt, verwende oracle status --hours 72, um aktuelle Sitzungen aufzulisten, und oracle session <id> --render, um die Verbindung wiederherzustellen – kein erneutes Ausführen und kein unnötiger Token-Verbrauch.

Führe --dry-run summary oder --dry-run full in Kombination mit --files-report aus, um genau zu prüfen, was gesendet werden würde, und um die Token-Kosten zu schätzen, bevor eine echte Anfrage gestellt wird. Dies verhindert unerwartete Überschreitungen bei großen Codebasen.

Wenn OPENAI_API_KEY gesetzt ist (oder --engine api explizit angegeben wird), leitet oracle die Anfragen über die API statt über den Browser weiter. Dies ermöglicht Claude, Grok, Codex und Multi-Modell-Workflows, die die Browser-Engine nicht unterstützt.

Starte einen Browser-Automatisierungs-Host auf einem entfernten Rechner mit oracle serve --host 0.0.0.0 --port 9473 --token <secret> und verbinde anschließend einen beliebigen oracle-Client damit. Nützlich, um lang laufende Browser-Sitzungen auf einen Server auszulagern.

Ein Entwickler bündelt die relevanten src/**-Dateien mit einem detaillierten Prompt, der den Fehler, den Fehlertext und die Einschränkungen beschreibt, und führt dann oracle --engine browser --model gpt-5.2-pro aus. Das Modell erhält den vollständigen Kontext und gibt einen Patch-Plan zurück. Wenn die Sitzung nach 20 Minuten getrennt wird, verbindet sich der Entwickler erneut, anstatt den Befehl neu auszuführen.

Bevor ein Entwickler eine kostspielige Ausführung startet, führt er oracle --dry-run summary --files-report -p "<task>" --file "src/**" aus, um zu sehen, welche Dateien einbezogen würden und wie viele Tokens sie verbrauchen würden, und kürzt dann den Dateisatz vor der eigentlichen Ausführung.

Wenn die Browser-Engine nicht geeignet ist, verwendet der Entwickler oracle --render --copy -p "<task>" --file "src/**", um den vollständig gebündelten Prompt in die Zwischenablage zu rendern, und fügt ihn anschließend manuell in eine beliebige Chat-Oberfläche ein.

Für einen komplexen, mehrtägigen Debugging-Aufwand schreibt ein Entwickler eine eigenständige Prompt-Datei mit einer 6–30 Sätze umfassenden Projektbeschreibung, Reproduktionsschritten und genauen Fehlermeldungen und fügt dann alle relevanten Konfigurations- und Einstiegspunktdateien hinzu. Der Prompt ist in sich geschlossen, sodass derselbe oracle-Befehl auch Tage später mit identischem Kontext erneut ausgeführt werden kann.