oracle

What it is

Oracle is a CLI and MCP server that bundles a prompt with the files you select, sends that context to an AI model through an API or a signed-in browser, and stores the result as a session. It is for developers and coding agents that need a second-model review grounded in the actual project.

How it works

• You can compose context with --file options, including files, directories, globs, and exclusions. Oracle previews the resolved files and token estimate before sending.
• It can operate in API mode (OpenAI, Azure OpenAI, Anthropic, Gemini, xAI, OpenRouter, etc.) or Browser mode (signed-in ChatGPT/Gemini browser session). The engine is chosen automatically or can be explicitly set with --engine api or --engine browser.
• Generated bundles include stable line numbers for citations (path:line). Binary or large browser inputs can be uploaded or bundled.
• Sessions are stored under ~/.oracle/sessions for later replay or background completion. Commands include status, session, restart, and follow-ups.
• For multi-model use, --models records per-model usage and outputs; MCP and agent integrations are available.

Getting started

• Install (Homebrew):

brew install steipete/tap/oracle

• Or install via npm:

npm install -g @steipete/oracle

• Quickstart (render bundle locally):

oracle --render \
  -p "Review the package metadata for release risks" \
  --file package.json

• To request an answer with an engine configured:

oracle \
  -p "Audit the model runner for race conditions" \
  --file "src/oracle/**/*.ts" \
  --file "!**/*.test.ts"

• Help/usage can be accessed via the quickstart and CLI reference documents.

Recent releases

• v0.17.0 (2026-08-03): Added explicit GPT-5.6 reasoning mode and effort controls, including Pro mode, session persistence, long-run handling, and fail-closed route validation.
• v0.16.1 (2026-07-23): Dependencies refreshed (Google GenAI, OpenAI, Clipboardy, Chrome DevTools protocol, Hono/MCP runtime security fixes, Oxc tooling, TSX).
• v0.16.0 (2026-07-12): Added ORACLE_BROWSER_MAX_CONCURRENT_TABS control, preserving config precedence and default limit.
• v0.15.2 (2026-07-06): Dependency updates (Google GenAI, OpenAI, Markdansi, osc-progress, Shiki, TokenTally, Vitest, Puppeteer, TypeScript native preview, Oxc tooling).
• v0.15.1 (2026-07-03): Bridge/Browser: transfer ChatGPT-generated files from browser host back to client over a token-protected artifact endpoint with capability discovery, safe filenames, and byte counts.

Traction

• Stars: 3534
• Forks: 353
• Open issues: 5

License and age

• License: MIT
• Created: 2025-11-14
• Last push: 2026-08-03

Behind the repo

• Repository owner: steipete
• Topics include: agents, ai, anthropic, gemini-pro, gpt-5-pro, openai, opus, sonnet