oracle

• Vous souhaitez poser une question approfondie à un grand modèle d'IA (GPT‑5.2 Pro, Gemini, Claude, etc.) sur votre base de code et avez besoin qu'il voie les fichiers sources pertinents, et non un simple extrait.
• Vous avez besoin d'une exécution en « réflexion longue » — des tâches qui prennent de 10 minutes à une heure — et souhaitez une session sauvegardée à laquelle vous pouvez vous reconnecter si le CLI expire.
• Vous devez contrôler exactement quels fichiers sont inclus dans le paquet (via des globs, des exclusions et la prise en charge de .gitignore) pour maintenir une consommation de tokens prévisible.
• Vous souhaitez prévisualiser la charge utile complète et le coût en tokens avec --dry-run avant d'envoyer quoi que ce soit à un modèle.

• Vous avez besoin d'un contexte conversationnel en temps réel et multi-tours sur de nombreux échanges — les exécutions oracle sont ponctuelles ; les exécutions précédentes ne sont pas mémorisées sans rattacher une session sauvegardée.
• Vous souhaitez utiliser un modèle autre que GPT ou Gemini via le moteur navigateur — ceux-ci nécessitent --engine api (Claude, Grok, Codex, etc.).
• Vos fichiers de contexte dépassent 1 Mo chacun — oracle rejette les fichiers au-delà de cette limite.

oracle fusionne votre invite avec un nombre illimité de fichiers, répertoires ou globs en une seule charge utile de requête. Passez --file plusieurs fois, combinez des inclusions et des exclusions préfixées par !, et oracle ignore intelligemment node_modules, dist, .git et autres répertoires indésirables automatiquement.

Le mode --engine browser pilote ChatGPT ou Gemini directement dans une session de navigateur — idéal pour les modèles accessibles uniquement via l'interface web. Il décide automatiquement s'il faut coller le contenu en ligne ou téléverser des pièces jointes en fonction de la taille (jusqu'à ~60 000 caractères en ligne, puis téléversement de fichier).

Toutes les exécutions sont stockées dans ~/.oracle/sessions. Si une longue exécution dans le navigateur se déconnecte ou expire, utilisez oracle status --hours 72 pour lister les sessions récentes et oracle session <id> --render pour vous rattacher — inutile de relancer et de dépenser des tokens à nouveau.

Exécutez --dry-run summary ou --dry-run full combiné avec --files-report pour inspecter exactement ce qui serait envoyé et estimer le coût en tokens avant toute requête réelle. Cela évite les dépassements imprévus sur les grandes bases de code.

Lorsque OPENAI_API_KEY est défini (ou que --engine api est explicite), oracle passe par l'API plutôt que par le navigateur. Cela déverrouille Claude, Grok, Codex et les flux de travail multi-modèles que le moteur de navigateur ne prend pas en charge.

Hébergez un hôte d'automatisation de navigateur sur une machine distante avec oracle serve --host 0.0.0.0 --port 9473 --token <secret>, puis connectez n'importe quel client oracle à celui-ci. Utile pour déléguer des sessions de navigateur de longue durée à un serveur.

Un développeur regroupe les fichiers src/** pertinents avec une invite détaillée décrivant le bug, le message d'erreur et les contraintes, puis exécute oracle --engine browser --model gpt-5.2-pro. Le modèle reçoit le contexte complet et renvoie un plan de correctif. Si la session se déconnecte après 20 minutes, le développeur se reconnecte plutôt que de relancer la commande.

Avant de s'engager dans une exécution coûteuse, un développeur exécute oracle --dry-run summary --files-report -p "<task>" --file "src/**" pour voir quels fichiers seraient inclus et combien de tokens ils consommeraient, puis réduit l'ensemble de fichiers avant la vraie exécution.

Lorsque le moteur de navigateur n'est pas adapté, le développeur utilise oracle --render --copy -p "<task>" --file "src/**" pour afficher le prompt groupé complet dans le presse-papiers, puis le colle manuellement dans n'importe quelle interface de chat.

Pour un effort de débogage complexe s'étalant sur plusieurs jours, un développeur rédige un fichier d'invite autonome contenant un briefing de projet de 6 à 30 phrases, des étapes de reproduction et les erreurs exactes, puis joint tous les fichiers de configuration et de point d'entrée pertinents. L'invite est autosuffisante afin que la même commande oracle puisse être réexécutée des jours plus tard avec un contexte identique.