Oracle (CLI) — 使い方

Oracle はプロンプト + 選択したファイルを一つの「ワンショット」リクエストにバンドルし、別モデルが実際のリポジトリコンテキストで回答できるようにする（API またはブラウザ自動化）。出力はアドバイスとして扱い、コードベース + テストで検証すること。

主な使い方（ブラウザ、GPT-5.2 Pro）

デフォルトワークフロー: --engine browser で ChatGPT の GPT-5.2 Pro を使用。これは「ヒューマン・イン・ザ・ループ」パス: 10分〜1時間かかることがある。再アタッチ可能なセッションが保存される。

推奨デフォルト:

•
ヘルプ表示（セッションごとに1回）:
- •npx -y @steipete/oracle --help
•
プレビュー（トークン消費なし）:
- •npx -y @steipete/oracle --dry-run summary -p "<タスク>" --file "src/**" --file "!**/*.test.*"
•
トークン/コスト確認:
- •npx -y @steipete/oracle --dry-run summary --files-report -p "<タスク>" --file "src/**"
•
ブラウザ実行（メインパス、長時間は正常）:
- •npx -y @steipete/oracle --engine browser --model gpt-5.2-pro -p "<タスク>" --file "src/**"
•
手動ペーストフォールバック（バンドル作成、クリップボードにコピー）:
- •npx -y @steipete/oracle --render --copy -p "<タスク>" --file "src/**"

--file はファイル、ディレクトリ、glob を受け付ける。複数回指定可能。

•
含める:
- •--file "src/**"（ディレクトリ glob）
- •--file src/index.ts（リテラルファイル）
- •--file docs --file README.md（ディレクトリ + ファイル）
•
除外（! プレフィックス）:
- •--file "src/**" --file "!src/**/*.test.ts" --file "!**/*.snap"
•
デフォルト動作:
- •デフォルト除外: node_modules, dist, coverage, .git, .turbo, .next, build, tmp
- •glob 展開時は .gitignore を尊重
- •シンボリックリンクを追わない
- •1MB 超のファイルは拒否

•~/.oracle/sessions に保存
•
実行がデタッチ/タイムアウトしたら再アタッチ:
- •一覧: oracle status --hours 72
- •アタッチ: oracle session <id> --render
•--slug "<3-5 words>" でセッション ID を読みやすく

Oracle はプロジェクト知識ゼロで開始。含めるべき内容: