oracle

mrud's avatarfrom mrud

Run long AI queries with Oracle CLI. Use for code reviews, summarization, or analysis that takes time. Always run in tmux.

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 2, 2026
[Developer Tools]

When & Why to Use This Skill

Oracle CLI is a specialized Claude skill designed for executing long-running AI queries that require deep analysis and persistence. It is optimized for time-intensive tasks such as comprehensive code reviews, large-scale document summarization, and complex system audits. By leveraging tmux integration, it ensures that AI processing sessions remain active in the background, allowing developers to manage high-context workflows without the risk of session timeouts or data loss.

Use Cases

  • Automated Code Reviews: Perform deep-dive analysis of entire source directories to identify architectural patterns, security vulnerabilities, or technical debt.
  • Large-Scale Document Summarization: Process extensive technical manuals, risk registers, or project documentation that require significant time and context to summarize accurately.
  • System & Data Auditing: Conduct thorough audits across multiple files and layers of an application to ensure compliance with coding standards and security protocols.
  • Persistent Session Management: Run background AI tasks using tmux, enabling users to disconnect and reattach to long-duration queries, check status, and replay sessions for later reference.
nameoracle
descriptionRun long AI queries with Oracle CLI. Use for code reviews, summarization, or analysis that takes time. Always run in tmux.

Oracle CLI

Run long-running AI queries. Always run in tmux so sessions persist.

Usage

# Run query (in tmux!)
oracle -p "Summarize the risk register" \
  --slug risk-register-summary \
  --file docs/risk-register.md docs/risk-matrix.md

# Code review
oracle -p "Review the TS data layer" \
  --slug review-ts-data-layer \
  --file "src/**/*.ts" \
  --file "!src/**/*.test.ts"

# Audit
oracle -p "Audit data layer" \
  --slug audit-data-layer \
  --file "src/**/*.ts" \
  --file README.md

Slug Naming

Choose descriptive slugs based on:

  • The task being performed
  • The project context
  • Make it meaningful for later reference

Session Management

# Check status
oracle status

# Prune old runs (1 week)
oracle status --clear --hours 168

# Replay a session
oracle status              # List runs, get ID
oracle session <id>        # Replay locally

Tips

  • Run in tmux: tmux new -s oracle-run
  • Reattach later: tmux attach -t oracle-run
  • Kill when done