oracle
Best practices for using the oracle CLI (prompt + file bundling, engines, sessions, and file attachment patterns).
Security Assessment
Detected risks:
About oracle
The oracle CLI is a tool designed to bundle prompts and selected files into a single request, enabling seamless interaction with external models like GPT and browser automation. It simplifies the process of contextualizing a task, allowing users to send complex data alongside a prompt to get more informed and accurate responses. By integrating real project files, it makes the responses more relevant and aligned with real-world code and project structures. Oracle’s design focuses on efficiency and accuracy, providing users with the context they need for complex AI-based tasks.
FAQ
What is the default engine used by oracle?
The default engine is 'browser' when using GPT‑5.2 Pro, providing a common and reliable path for long-running tasks.
How can I preview the token usage before running the command?
You can use the 'oracle --dry-run' command to preview the payload and token usage without making an actual request. The options '--dry-run summary' and '--files-report' can be used for this purpose.
Can I attach multiple files to a request?
Yes, you can attach multiple files using the '--file' option, and you can use directories and glob patterns to select files. Multiple files can be passed either as separate arguments or comma-separated.
What happens if a session times out or detaches?
If a session times out or detaches, you should reattach to the stored session instead of rerunning the command. You can use 'oracle session <id> --render' to reattach.
Is oracle compatible with other models besides GPT-5.2 Pro?
Yes, oracle supports other engines such as Claude, Grok, and Codex when using the '--engine api' option, in addition to GPT and Gemini models.
Install oracle
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
steipete/clawdis