oracle

• Você quer fazer uma pergunta profunda a um grande modelo de IA (GPT‑5.2 Pro, Gemini, Claude, etc.) sobre sua base de código e precisa que ele veja os arquivos-fonte relevantes, não apenas um trecho.
• Você precisa de uma execução de "pensamento longo" — tarefas que levam de 10 minutos a uma hora — e quer uma sessão armazenada à qual possa se reconectar caso a CLI expire.
• Você precisa controlar exatamente quais arquivos são incluídos no pacote (via globs, exclusões e reconhecimento de .gitignore) para manter o gasto de tokens previsível.
• Você quer visualizar o payload completo e o custo em tokens com --dry-run antes de enviar qualquer coisa a um modelo.

• Você precisa de contexto conversacional em tempo real e múltiplos turnos ao longo de muitas trocas de ida e volta — as execuções do oracle são únicas; execuções anteriores não são lembradas sem reanexar uma sessão armazenada.
• Você quer usar um modelo diferente de GPT ou Gemini pelo mecanismo do navegador — esses requerem --engine api (Claude, Grok, Codex, etc.).
• Seus arquivos de contexto excedem 1 MB cada — o oracle rejeita arquivos acima desse limite.

O oracle mescla seu prompt com qualquer número de arquivos, diretórios ou globs em um único payload de requisição. Passe --file múltiplas vezes, combine inclusões e exclusões prefixadas com !, e o oracle ignora inteligentemente node_modules, dist, .git e outros diretórios desnecessários de forma automática.

O modo --engine browser controla o ChatGPT ou o Gemini diretamente em uma sessão de navegador — ideal para modelos acessíveis apenas pela interface web. Ele decide automaticamente se deve colar o conteúdo inline ou fazer upload de anexos com base no tamanho (até ~60 mil caracteres inline e, acima disso, upload de arquivo).

Todas as execuções são armazenadas em ~/.oracle/sessions. Se uma execução longa do navegador for desconectada ou expirar, use oracle status --hours 72 para listar sessões recentes e oracle session <id> --render para reconectar — sem necessidade de executar novamente e gastar tokens.

Execute --dry-run summary ou --dry-run full combinado com --files-report para inspecionar exatamente o que seria enviado e estimar o custo em tokens antes de qualquer requisição real ser feita. Isso evita surpresas com uso excessivo em bases de código grandes.

Quando OPENAI_API_KEY está definido (ou --engine api é explícito), o oracle roteia pela API em vez do navegador. Isso desbloqueia Claude, Grok, Codex e fluxos de trabalho multi-modelo que o motor de navegador não suporta.

Sirva um host de automação de navegador em uma máquina remota com oracle serve --host 0.0.0.0 --port 9473 --token <secret>, e então conecte qualquer cliente oracle a ele. Útil para transferir sessões de navegador de longa duração para um servidor.

Um desenvolvedor empacota os arquivos src/** relevantes com um prompt detalhado descrevendo o bug, o texto do erro e as restrições, em seguida executa oracle --engine browser --model gpt-5.2-pro. O modelo recebe o contexto completo e retorna um plano de correção. Se a sessão for desconectada após 20 minutos, o desenvolvedor a reconecta em vez de executar novamente.

Antes de se comprometer com uma execução custosa, um desenvolvedor executa oracle --dry-run summary --files-report -p "<task>" --file "src/**" para ver quais arquivos seriam incluídos e quantos tokens eles consumiriam, e então reduz o conjunto de arquivos antes da execução real.

Quando o motor do navegador não é compatível, o desenvolvedor usa oracle --render --copy -p "<task>" --file "src/**" para renderizar o prompt completo e agrupado na área de transferência, colando-o manualmente em qualquer interface de chat.

Para um esforço de depuração complexo que se estende por vários dias, um desenvolvedor escreve um arquivo de prompt independente com um briefing do projeto de 6 a 30 frases, etapas de reprodução e erros exatos, anexando em seguida todos os arquivos de configuração e de ponto de entrada relevantes. O prompt é autossuficiente para que o mesmo comando oracle possa ser executado novamente dias depois com um contexto idêntico.