| name | oracle |
| description | Use the @steipete/oracle CLI to bundle a prompt plus the right files and get a second-model review (API or browser) for debugging, refactors, design checks, or cross-validation. |
Oracle CLI
Bundle prompt + files into a one-shot request to another model (GPT-5.2 Pro, Claude, Gemini) for review. Treat outputs as advisory.
Quick Start
npx -y @steipete/oracle --dry-run summary -p "<task>" --file "src/**"
npx -y @steipete/oracle --engine browser --model gpt-5.2-pro -p "<task>" --file "src/**"
npx -y @steipete/oracle --render --copy -p "<task>" --file "src/**"
Golden Path
- Pick tight file set (fewest files with the truth)
- Preview first (
--dry-run + --files-report)
- Run browser mode for GPT-5.2 Pro; API for Claude/Grok
- If timeout: reattach to session, don't re-run
File Selection
--file "src/**"
--file "!src/**/*.test.ts"
--file src/index.ts --file docs/
Default ignores: node_modules, dist, .git, build, etc.
For detailed usage, engines, sessions, and prompt templates, see reference.md.