oracle

• Haluat esittää suurelle tekoälymallille (GPT‑5.2 Pro, Gemini, Claude jne.) syvällisen kysymyksen koodipohjastasi ja tarvitset sen näkevän asiaankuuluvat lähdetiedostot, ei pelkästään katkelman.
• Tarvitset "pitkän ajattelun" suorituksen — tehtäviä, jotka kestävät 10 minuutista tuntiin — ja haluat tallennetun istunnon, johon voit liittyä uudelleen, jos CLI aikakatkaistaan.
• Sinun täytyy hallita tarkasti, mitkä tiedostot paketoidaan (globien, poissulkemisten ja .gitignore-tietoisuuden avulla), jotta tokenikustannukset pysyvät ennakoitavina.
• Haluat esikatsella koko hyötykuorman ja tokenikustannukset --dry-run-valitsimella ennen kuin lähetät mitään mallille.

• Tarvitset reaaliaikaisen, moniosaisen keskustelukontekstin useiden edestakaisin vaihdettujen viestien välille — oracle-ajot ovat kertaluonteisia; aiempia ajoja ei muisteta ilman tallennetun session uudelleenliittämistä.
• Haluat käyttää muuta mallia kuin GPT tai Gemini selainmoottorin kautta — ne vaativat --engine api -vaihtoehdon (Claude, Grok, Codex jne.).
• Kontekstitiedostosi ylittävät 1 Mt kukin — oracle hylkää tuon rajan ylittävät tiedostot.

oracle yhdistää kehotteesi minkä tahansa määrän tiedostoja, hakemistoja tai glob-malleja yhdeksi pyyntöpaketiksi. Anna --file-lippu useita kertoja, sekoita sisällytyksiä ja !-etuliitteisiä poissulkemisia, ja oracle ohittaa automaattisesti älykkäästi node_modules-, dist-, .git- ja muut häiriöhakemistot.

--engine browser -tila ohjaa ChatGPT:tä tai Geminiä suoraan selainistunnossa — ihanteellinen malleille, joihin pääsee vain verkkoliittymän kautta. Se päättää automaattisesti, liitetäänkö sisältö suoraan tekstikenttään vai ladataanko se tiedostona liitteenä koon perusteella (enintään noin 60 000 merkkiä suoraan tekstikenttään, sen jälkeen tiedostona).

Kaikki ajot tallennetaan hakemistoon ~/.oracle/sessions. Jos pitkä selainajo katkeaa tai aikakatkaistaan, käytä komentoa oracle status --hours 72 listataksesi viimeaikaiset istunnot ja oracle session <id> --render liittyäksesi takaisin — sinun ei tarvitse ajaa komentoa uudelleen ja kuluttaa tokeneita.

Suorita --dry-run summary tai --dry-run full yhdistettynä --files-report-valitsimeen tarkastaaksesi täsmälleen, mitä lähetettäisiin, ja arvioidaksesi token-kustannukset ennen varsinaisen pyynnön tekemistä. Tämä estää yllättävät ylikäytöt suurissa koodikannoissa.

Kun OPENAI_API_KEY on asetettu (tai --engine api on eksplisiittisesti määritelty), oracle reitittää pyynnöt API:n kautta selaimen sijaan. Tämä mahdollistaa Claude-, Grok-, Codex- ja monimoottorityönkulut, joita selainmoottori ei tue.

Käynnistä selainautomaation isäntä etäkoneella komennolla oracle serve --host 0.0.0.0 --port 9473 --token <secret> ja yhdistä siihen mikä tahansa oracle-asiakas. Hyödyllinen pitkäkestoisten selainistuntojen siirtämiseen palvelimelle.

Kehittäjä pakkaa asiaankuuluvat src/**-tiedostot yksityiskohtaisen kehotteen kanssa, jossa kuvataan bugi, virheilmoitus ja rajoitukset, ja ajaa sitten komennon oracle --engine browser --model gpt-5.2-pro. Malli saa täyden kontekstin ja palauttaa korjaussuunnitelman. Jos istunto katkeaa 20 minuutin jälkeen, kehittäjä liittää sen uudelleen sen sijaan, että ajaisi komennon uudelleen.

Ennen kalliin ajon aloittamista kehittäjä suorittaa komennon oracle --dry-run summary --files-report -p "<task>" --file "src/**" nähdäkseen, mitkä tiedostot sisältyisivät ajoon ja kuinka monta tokenia ne kuluttaisivat, minkä jälkeen hän rajaa tiedostojoukkoa ennen varsinaista ajoa.

Kun selainmoottori ei ole sopiva, kehittäjä käyttää komentoa oracle --render --copy -p "<task>" --file "src/**" renderöidäkseen täyden yhdistetyn kehotteen leikepöydälle, minkä jälkeen hän liittää sen manuaalisesti mihin tahansa chat-käyttöliittymään.

Monimutkaista, useita päiviä kestävää virheenkorjausta varten kehittäjä kirjoittaa erillisen kehotetiedoston, joka sisältää 6–30 lauseen projektikuvauksen, ongelman toistamisvaiheet ja tarkat virheilmoitukset, sekä liittää mukaan kaikki olennaiset konfiguraatio- ja sisääntulopistotiedostot. Kehote on täysin omavarainen, joten saman oracle-komennon voi ajaa uudelleen päivienkin kuluttua täysin samalla kontekstilla.