oracle

Bundles prompts and repository files into one-shot requests for external model consultation.

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/shalevamin/Tau_agent --skill oracle-shalevamin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: oracle
Source: https://github.com/shalevamin/Tau_agent/tree/main/tau-agent-main/skills/oracle
Command: npx skills add https://github.com/shalevamin/Tau_agent --skill oracle-shalevamin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @steipete/oracle.

What problem does it solve? Getting a second opinion from another AI model on a codebase usually requires manually copying files and context into a chat window. This Skill guides the use of the oracle CLI, which bundles your prompt plus selected files into a single one-shot request so another model can answer with real repository context via API or browser automation. ## Core Features & Use Cases - Prompt and File Bundling: Attach files, directories, and globs with --file, including exclusion patterns, .gitignore awareness, and size limits. - Browser and API Engines: Run long GPT-5.2 Pro browser sessions or use the API engine for Claude, Grok, Codex, and multi-model runs. - Session Management: Reattach to detached or long-running stored sessions instead of re-running, with readable slugs and status listing. - Use Case: You hit a stubborn bug in your TypeScript backend. You run a dry-run to preview token cost, then launch a browser-mode oracle run with your source files attached, and reattach to the session an hour later to read the advisory analysis. ## Quick Start Ask the agent to run oracle in browser mode with GPT-5.2 Pro, attaching your src directory, to get a second opinion on a bug you are investigating.

Frequently Asked Questions about oracle

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I attach files to an oracle CLI prompt?

Use the --file flag with files, directories, or glob patterns, repeating it as needed. Exclusions use a leading exclamation mark, such as --file "src/**" --file "!**/*.test.*". Globs honor .gitignore, skip node_modules and similar directories, and reject files over 1 MB.

What is the difference between oracle browser and API engines?

The browser engine drives ChatGPT with GPT or Gemini models and supports long GPT-5.2 Pro sessions, while the API engine is required for Claude, Grok, Codex, or multi-model runs. Oracle auto-picks API when OPENAI_API_KEY is set, otherwise browser.

How do I preview token cost before running oracle?

Run oracle with --dry-run summary plus --files-report to see the payload and token estimate without spending anything. Use --dry-run full to inspect the complete rendered prompt before committing to a run.

What should I do when an oracle browser run times out?

Do not re-run the prompt; reattach to the stored session instead. List recent sessions with oracle status --hours 72, then attach with oracle session <id> --render. Sessions live under ~/.oracle/sessions.

Can oracle remember context from previous runs?

No, oracle runs are one-shot and the model has no memory of prior runs. To restore context, re-run with the same prompt and --file set, or reattach to a still-running stored session.