oracle

• Quieres hacerle una pregunta profunda a un modelo de IA grande (GPT‑5.2 Pro, Gemini, Claude, etc.) sobre tu base de código y necesitas que vea los archivos fuente relevantes, no solo un fragmento.
• Necesitas una ejecución de "reflexión prolongada" — tareas que tardan entre 10 minutos y una hora — y quieres una sesión almacenada a la que puedas reconectarte si el CLI agota el tiempo de espera.
• Necesitas controlar exactamente qué archivos se incluyen en el paquete (mediante globs, exclusiones y compatibilidad con .gitignore) para mantener el gasto en tokens predecible.
• Quieres previsualizar el payload completo y el coste en tokens con --dry-run antes de enviar nada a un modelo.

• Necesitas contexto conversacional en tiempo real y de múltiples turnos a lo largo de muchos intercambios — las ejecuciones de oracle son de un solo disparo; las ejecuciones anteriores no se recuerdan sin volver a adjuntar una sesión almacenada.
• Quieres usar un modelo distinto de GPT o Gemini a través del motor del navegador — esos requieren --engine api (Claude, Grok, Codex, etc.).
• Tus archivos de contexto superan 1 MB cada uno — oracle rechaza archivos que superen ese límite.

oracle combina tu prompt con cualquier cantidad de archivos, directorios o patrones glob en un único payload de solicitud. Pasa --file varias veces, mezcla inclusiones y exclusiones con prefijo !, y oracle omite inteligentemente node_modules, dist, .git y otros directorios innecesarios de forma automática.

El modo --engine browser controla ChatGPT o Gemini directamente en una sesión del navegador — ideal para modelos accesibles únicamente a través de la interfaz web. Decide automáticamente si pegar el contenido de forma integrada o cargar archivos adjuntos según el tamaño (hasta ~60 000 caracteres de forma integrada, luego carga de archivos).

Todas las ejecuciones se almacenan en ~/.oracle/sessions. Si una ejecución larga del navegador se desconecta o agota el tiempo de espera, usa oracle status --hours 72 para listar las sesiones recientes y oracle session <id> --render para reconectarte — sin necesidad de volver a ejecutar y gastar tokens de nuevo.

Ejecuta --dry-run summary o --dry-run full combinado con --files-report para inspeccionar exactamente qué se enviaría y estimar el coste en tokens antes de realizar ninguna solicitud real. Esto evita desbordamientos inesperados en bases de código grandes.

Cuando OPENAI_API_KEY está configurado (o --engine api es explícito), oracle enruta a través de la API en lugar del navegador. Esto desbloquea Claude, Grok, Codex y flujos de trabajo multi-modelo que el motor de navegador no admite.

Sirve un host de automatización de navegador en una máquina remota con oracle serve --host 0.0.0.0 --port 9473 --token <secret>, luego conecta cualquier cliente de oracle a él. Útil para delegar sesiones de navegador de larga duración a un servidor.

Un desarrollador agrupa los archivos src/** relevantes con un prompt detallado que describe el error, el texto del error y las restricciones, luego ejecuta oracle --engine browser --model gpt-5.2-pro. El modelo recibe el contexto completo y devuelve un plan de parche. Si la sesión se desconecta después de 20 minutos, el desarrollador se vuelve a conectar en lugar de volver a ejecutar el comando.

Antes de comprometerse con una ejecución costosa, un desarrollador ejecuta oracle --dry-run summary --files-report -p "<task>" --file "src/**" para ver qué archivos se incluirían y cuántos tokens consumirían, y luego reduce el conjunto de archivos antes de la ejecución real.

Cuando el motor del navegador no es adecuado, el desarrollador utiliza oracle --render --copy -p "<task>" --file "src/**" para renderizar el prompt completo empaquetado al portapapeles y, a continuación, lo pega manualmente en cualquier interfaz de chat.

Para un esfuerzo de depuración complejo que abarca varios días, un desarrollador escribe un archivo de prompt independiente con un resumen del proyecto de 6 a 30 oraciones, pasos para reproducir el problema y errores exactos, y luego adjunta todos los archivos de configuración y puntos de entrada relevantes. El prompt es autónomo para que el mismo comando de oracle pueda volver a ejecutarse días después con un contexto idéntico.