oracle

• Vuoi porre una domanda approfondita a un grande modello AI (GPT‑5.2 Pro, Gemini, Claude, ecc.) riguardo alla tua codebase e hai bisogno che veda i file sorgente rilevanti, non solo uno snippet.
• Hai bisogno di un'esecuzione "long think" — attività che richiedono da 10 minuti a un'ora — e vuoi una sessione memorizzata a cui poter ricollegarti se la CLI va in timeout.
• Devi controllare esattamente quali file vengono inclusi nel bundle (tramite glob, esclusioni e supporto a .gitignore) per mantenere prevedibile il consumo di token.
• Vuoi visualizzare in anteprima il payload completo e il costo in token con --dry-run prima di inviare qualsiasi cosa a un modello.

• Hai bisogno di un contesto conversazionale multi-turno in tempo reale attraverso molti scambi — le esecuzioni di oracle sono one-shot; le esecuzioni precedenti non vengono ricordate senza ricollegare una sessione salvata.
• Vuoi utilizzare un modello diverso da GPT o Gemini tramite il motore browser — quelli richiedono --engine api (Claude, Grok, Codex, ecc.).
• I tuoi file di contesto superano 1 MB ciascuno — oracle rifiuta i file oltre quel limite.

oracle unisce il tuo prompt con un numero qualsiasi di file, directory o glob in un unico payload di richiesta. Passa --file più volte, combina inclusioni ed esclusioni con prefisso !, e oracle salta automaticamente e in modo intelligente node_modules, dist, .git e altre directory superflue.

La modalità --engine browser gestisce ChatGPT o Gemini direttamente in una sessione browser — ideale per i modelli accessibili solo tramite interfaccia web. Decide automaticamente se incollare il contenuto inline o caricare allegati in base alle dimensioni (fino a circa 60k caratteri inline, poi caricamento file).

Tutte le esecuzioni vengono salvate in ~/.oracle/sessions. Se una lunga esecuzione del browser si disconnette o va in timeout, usa oracle status --hours 72 per elencare le sessioni recenti e oracle session <id> --render per ricollegarti — senza dover rieseguire e consumare token di nuovo.

Esegui --dry-run summary o --dry-run full combinato con --files-report per ispezionare esattamente ciò che verrebbe inviato e stimare il costo in token prima che venga effettuata qualsiasi richiesta reale. Questo previene sforamenti inaspettati su codebase di grandi dimensioni.

Quando OPENAI_API_KEY è impostato (o --engine api è esplicito), oracle instrada le richieste tramite l'API invece del browser. Questo sblocca Claude, Grok, Codex e i flussi di lavoro multi-modello che il motore browser non supporta.

Avvia un host di automazione browser su una macchina remota con oracle serve --host 0.0.0.0 --port 9473 --token <secret>, quindi connetti qualsiasi client oracle ad esso. Utile per delegare sessioni browser di lunga durata a un server.

Uno sviluppatore raggruppa i file src/** rilevanti con un prompt dettagliato che descrive il bug, il testo dell'errore e i vincoli, quindi esegue oracle --engine browser --model gpt-5.2-pro. Il modello riceve il contesto completo e restituisce un piano di patch. Se la sessione si disconnette dopo 20 minuti, lo sviluppatore si ricollega invece di rieseguire il comando.

Prima di avviare un'esecuzione costosa, uno sviluppatore esegue oracle --dry-run summary --files-report -p "<task>" --file "src/**" per vedere quali file verrebbero inclusi e quanti token consumerebbero, quindi riduce l'insieme di file prima dell'esecuzione reale.

Quando il motore del browser non è adatto, lo sviluppatore utilizza oracle --render --copy -p "<task>" --file "src/**" per eseguire il rendering del prompt completo nel pacchetto negli appunti, quindi lo incolla manualmente in qualsiasi interfaccia di chat.

Per un'impegno di debug complesso che si estende su più giorni, uno sviluppatore redige un file di prompt autonomo contenente un briefing del progetto da 6 a 30 frasi, i passaggi per riprodurre il problema e gli errori esatti, allegando poi tutti i file di configurazione e di entrypoint pertinenti. Il prompt è autosufficiente, così lo stesso comando oracle può essere rieseguito giorni dopo con un contesto identico.