用途：Oracle CLI 的作用是把提示词和挑选出的仓库文件打包成一个「一次性」请求，让另一个模型带着真实的仓库上下文来作答，可用于调试、重构、设计检查等场景。其输出属于参考建议，需要结合代码库与测试自行验证。
主要能力与默认工作流：默认工作流是 --engine browser，在 ChatGPT 中用 GPT 处理；也可使用 API，但仅在你明确需要时才用。核心思路是「刚好够用」的上下文：更少的文件加更好的提示词优于整仓库倾倒。
使用方式：查看帮助可执行 npx -y @steipete/oracle --help。先做无 token 消耗的预览：npx -y @steipete/oracle --dry-run summary -p "<task>" --file "src/" --file "!/.test."。查看 token 与成本情况：npx -y @steipete/oracle --dry-run summary --files-report -p "<task>" --file "src/"。浏览器运行：npx -y @steipete/oracle --engine browser -p "<task>" --file "src/"。手动粘贴回退：npx -y @steipete/oracle --render --copy -p "<task>" --file "src/**"。
文件附加：用 --file 包含，例如 --file "src/" 或 --file src/index.ts；用 --file "!src//*.test.ts" 排除。默认忽略 node_modules、dist、coverage、.git 等目录，大于 1 MB 的文件会被拒绝。
预算与会话：目标是把总输入控制在约 196k token 以内，可用 --files-report 提前发现占 token 的文件。会话存放在 ~/.oracle/sessions，可用 oracle status --hours 72 列出，用 oracle session <id> --render 重新附加；如遇运行分离或超时，应重新附加已存储会话而非重跑。可用 --slug "<3-5 words>" 生成易读的会话 ID。
限制与安全：默认不要附加密钥；优先遵循最小必要上下文，少量文件配合更好的提示词，而不是整仓库输出。其余关于收费、平台等细节暂未提供。