steipete/oracle

Ask the oracle when you're stuck. Invoke GPT-5 Pro with a custom context and files.

What it solves

Oracle 是一个 CLI 工具，旨在简化向 AI 模型提供大量上下文（文件和目录）的过程。它通过将提示和本地文件打包成单一请求，消除手动将文件复制粘贴到聊天界面的繁琐，让用户能够通过 API 或浏览器自动化与各种 LLM 交互。

How it works

Oracle 通过两个主要引擎运行：

  • API Engine：使用 OpenAI、Google（Gemini）和 Anthropic（Claude）的官方 API 发送提示和打包文件。
  • Browser Engine：自动化 Chrome 浏览器直接与 ChatGPT 或 Gemini 交互，允许用户在不需要 API 密钥的情况下使用高端模型（如 GPT-5.5 Pro）。

它支持多模型运行，单个提示可同时发送给多个 AI 模型进行比较。还管理会话，用户可以通过 session ID 或 response ID 继续先前的对话。

Who it’s for

  • 开发者：需要将整个代码库或特定文件集喂入 LLM 进行审查、调试或架构规划。
  • 高级用户：希望在一次运行中比较不同 AI 模型（GPT、Gemini、Claude）的响应。
  • 没有 API 密钥的用户：倾向使用基于浏览器的自动化来访问高级 AI 模型。

Highlights

  • Multi-Engine Support：在 API 与实验性的浏览器自动化之间切换。
  • Multi-Model Advisory Panels：一次查询多个模型并聚合结果。
  • Context Bundling：使用 glob 和排除规则精确附加本地文件和目录。
  • Handoffs and Lineage：通过 --followup 继续先前的对话，并以树形格式跟踪会话历史。
  • MCP Integration：作为 Model Context Protocol (MCP) 服务器供 Claude Code、Cursor 等工具使用。
  • Manual Fallback：在自动化受阻时，渲染并复制打包内容以手动粘贴。