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:在自動化受阻時,渲染並複製打包內容以手動貼上。