oracle

• 大規模AIモデル（GPT‑5.2 Pro、Gemini、Claudeなど）にコードベースに関する深い質問をしたい場合、スニペットだけでなく関連するソースファイル全体を参照させる必要があります。
• 「長時間思考」の実行（10分から1時間かかるタスク）が必要で、CLIがタイムアウトした場合に再接続できる保存済みセッションが欲しい。
• トークン消費を予測可能に保つため、バンドルするファイルを（グロブ、除外設定、.gitignore の認識を通じて）正確に制御する必要があります。
• モデルに何かを送信する前に、--dry-run でペイロード全体とトークンコストをプレビューしたい。

• リアルタイムで多数のやり取りにわたるマルチターンの会話コンテキストが必要な場合 — oracle の実行は1回限りであり、保存済みセッションを再アタッチしない限り、以前の実行内容は記憶されません。
• ブラウザエンジン経由でGPTまたはGemini以外のモデルを使用したい場合 — それらには --engine api が必要です（Claude、Grok、Codexなど）。
• コンテキストファイルがそれぞれ1 MBを超える場合 — oracle はその制限を超えるファイルを拒否します。

oracleは、プロンプトと任意の数のファイル、ディレクトリ、またはグロブを1つのリクエストペイロードにまとめます。--fileを複数回指定し、インクルードと!プレフィックスの除外を組み合わせることができます。また、oracleはnode_modules、dist、.gitなどのノイズディレクトリを自動的にスキップします。

--engine browser モードは、ChatGPT または Gemini をブラウザセッション上で直接操作します。これは、Web UI 経由でのみアクセス可能なモデルに最適です。コンテンツをインラインで貼り付けるか、添付ファイルとしてアップロードするかを、サイズに基づいて自動的に判断します（インラインは最大約60,000文字まで対応し、それを超える場合はファイルアップロードに切り替わります）。

すべての実行は ~/.oracle/sessions に保存されます。長時間のブラウザ実行が切断またはタイムアウトした場合は、oracle status --hours 72 で最近のセッションを一覧表示し、oracle session <id> --render で再接続できます。トークンを消費して再実行する必要はありません。

--dry-run summary または --dry-run full を --files-report と組み合わせて実行することで、実際のリクエストを送信する前に、送信される内容を正確に確認し、トークンコストを見積もることができます。これにより、大規模なコードベースにおける予期しないコスト超過を防ぐことができます。

OPENAI_API_KEY が設定されている場合（または --engine api が明示的に指定されている場合）、oracle はブラウザの代わりに API 経由でルーティングします。これにより、ブラウザエンジンではサポートされていない Claude、Grok、Codex、およびマルチモデルワークフローが利用可能になります。

oracle serve --host 0.0.0.0 --port 9473 --token <secret> を使用してリモートマシン上でブラウザ自動化ホストを起動し、任意の oracle クライアントから接続できます。長時間実行されるブラウザセッションをサーバーにオフロードする場合に便利です。

開発者はバグ、エラーテキスト、および制約を説明する詳細なプロンプトとともに関連する src/** ファイルをまとめ、oracle --engine browser --model gpt-5.2-pro を実行します。モデルは完全なコンテキストを受け取り、パッチ計画を返します。20分後にセッションが切断された場合、開発者は再実行するのではなく、セッションに再接続します。

コストのかかる実行にコミットする前に、開発者は oracle --dry-run summary --files-report -p "<task>" --file "src/**" を実行して、どのファイルが含まれるか、またそれらがどれだけのトークンを消費するかを確認し、本番実行の前にファイルセットを絞り込みます。

ブラウザエンジンが適切でない場合、開発者は oracle --render --copy -p "<task>" --file "src/**" を使用して、バンドルされた完全なプロンプトをクリップボードにレンダリングし、任意のチャットインターフェースに手動で貼り付けます。

複数日にわたる複雑なデバッグ作業において、開発者はスタンドアロンのプロンプトファイルを作成します。このファイルには、6〜30文のプロジェクト概要、再現手順、および正確なエラー内容が記載され、関連するすべての設定ファイルとエントリーポイントファイルが添付されます。このプロンプトは自己完結型であるため、数日後に同じ oracle コマンドを実行しても、まったく同じコンテキストで再開することができます。