oracle

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

1|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/Cyandex/ErnOS --skill oracle-cyandex
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: oracle
Source: https://github.com/Cyandex/ErnOS/tree/main/skills/oracle
Command: npx skills add https://github.com/Cyandex/ErnOS --skill oracle-cyandex

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @steipete/oracle.

What problem does it solve? Getting a second opinion from a frontier model on a codebase usually means manually copying files into a chat window, losing context, and wasting tokens. The oracle CLI 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 + File Bundling: Attach files, directories, and globs with --file, including negation patterns, .gitignore awareness, and automatic exclusion of node_modules, dist, and files over 1 MB. - Browser and API Engines: Run long-thinking sessions with GPT-5.2 Pro in ChatGPT via --engine browser, or use --engine api for Claude, Grok, Codex, and multi-model runs. - Session Management: Long browser runs are stored under ~/.oracle/sessions; list them with oracle status and reattach with oracle session <id> --render instead of re-running. - Dry-Run Previews: Estimate payload size and token spend with --dry-run summary and --files-report before spending anything. - Use Case: You hit a stubborn bug in a TypeScript service. Run oracle --engine browser --model gpt-5.2-pro -p "<task>" --file "src/**" to get a deep, context-aware analysis from GPT-5.2 Pro, then verify the advisory output against your code and tests. ## Quick Start Ask the assistant to run oracle with the browser engine and GPT-5.2 Pro, attaching your src directory, to get a second opinion on your current bug or design question.

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 globs, and repeat it as needed, for example --file "src/**" --file "!**/*.test.*". It honors .gitignore, skips node_modules and similar directories by default, and rejects files over 1 MB.

How do I preview token usage before running oracle?▼

Run oracle with --dry-run summary plus --files-report to see the payload and estimated token spend without sending anything. Use --dry-run full to inspect the complete rendered bundle.

Should I use the browser engine or the API engine?▼

Use --engine browser for the standard GPT-5.2 Pro ChatGPT workflow, which supports long-running sessions. Use --engine api for Claude, Grok, Codex, or multi-model runs; the CLI auto-picks api when OPENAI_API_KEY is set.

What do I do when an oracle browser run times out or detaches?▼

Do not re-run the prompt, since long browser sessions are normal. List stored sessions with oracle status --hours 72 and reattach using oracle session <id> --render to retrieve the result.

Can oracle see secrets in my attached files?▼

Oracle sends whatever you attach, so avoid including .env files, key files, or auth tokens. Redact aggressively and share only the files required to answer the question.