Oracle CLI Reference
Single-page reference for every oracle subcommand. Each command maps to
one or more MCP tools of the same name.
Global flags
-V, --version output the version number
-h, --help display help for command
Commands
oracle ask
Ask Oracle anything with full project context.
oracle ask "Why is service X timing out?"
oracle ask "review this" -f "src/**/*.ts"
oracle ask "what's in our latest PR?" --include-gh
oracle ask "review" --soul engineer
| Flag | Purpose |
|---|---|
-f, --files <glob> |
Include code files (supports !exclude patterns) |
--include-docs |
Inject .oracle/docs/ knowledge base |
--include-gh |
Include GitHub PR/issue context |
--soul <name> |
Personality: engineer, socratic, witty, etc. |
--conversation <id> |
Multi-turn: recall prior answers in same conversation |
--scope <project|global> |
Memory scope (default: project) |
--json |
Output structured JSON |
oracle agent
Autonomous coding loop — reads, writes, edits files, runs shell commands.
oracle agent "add a --verbose flag and update the README"
oracle agent "refactor auth" --plan --yes
oracle agent "fix login bug" --review
oracle agent "add validation" --json
oracle agent "continue" --resume cp-20260723-...
oracle agent "investigate" --read-only
oracle agent "deploy" --approval-mode risky
| Flag | Purpose |
|---|---|
--plan |
Read-only investigation pass, then confirm before executing |
--yes |
Skip confirmation prompt when using --plan |
--review |
Self-review pass after completion |
--resume <id> |
Resume from a saved checkpoint |
--json |
Structured output with finalText, steps, checkpointId |
--read-only |
No mutations; read-only investigation |
--approval-mode <mode> |
Override approval policy: off, risky, or all-mutations |
--max-steps <n> |
Cap the loop (default 20, max 50) |
--provider <name> |
Override provider for this run |
--model <name> |
Override model for this run |
Related: oracle agent-checkpoints — list or delete checkpoints.
oracle memory
Persistent memory management.
oracle memory remember "Dashboard uses connection pool Y"
oracle memory search "connection pool"
oracle memory list
oracle memory stats
oracle memory consolidate
oracle memory prune --days 30
oracle memory promote <id>
oracle wiki
Compile memory into topic-grouped wiki pages.
oracle wiki build "auth"
oracle wiki list
oracle wiki get "auth"
oracle docs
Manage .oracle/docs/ knowledge base.
oracle docs list
oracle docs add README.md
oracle docs search "deployment"
oracle docs remove old-guide.md
oracle web
Web search, fetch, and structured extraction.
oracle web search "Redis timeout causes"
oracle web fetch https://example.com/api-docs
oracle web extract https://example.com/pricing --schema price
Providers: Brave, Tavily, Firecrawl, AgentQL (auto-fallback).
oracle msg
Inter-agent message bus.
oracle msg send -f lead -t builder -b "start the task"
oracle msg send -f lead -t "*" -b "team standup in 5"
oracle msg inbox -a builder
oracle msg inbox -a builder --wait --timeout 120
oracle msg ack -a builder <id>
oracle msg agents
oracle msg thread --reply-to <id> -b "done"
oracle msg watch -a builder --exec 'notify-send "msg from $ORACLE_MSG_FROM"'
oracle task
Task planning, tracking, and verification.
oracle task create --title "Add rate limiter" --created-by lead --assignee builder \
--checklist "implement" "add tests" "update docs"
oracle task list --assignee builder --active
oracle task get <id>
oracle task update <id> -a builder --status in_progress --note "starting"
oracle task check <id> 0 # check off item 0
oracle task submit <id> -a builder --summary "done"
oracle task close <id> -a lead # approve
oracle task close <id> -a lead --reject --note "..." # reject
oracle task board --created-by lead
Task lifecycle messages are linked persistently and can be replayed with
oracle swarm recover if a process stops between the task write and message
delivery.
oracle schedule
Runtime-backed cron task scheduler.
oracle schedule list
oracle schedule add "daily-backup" "0 2 * * *" "tar czf /tmp/backup.tgz src/"
oracle schedule update <id> --cron "*/10 * * * *"
oracle schedule update <id> --status paused
oracle schedule run <id> # run once immediately
oracle schedule watch # foreground Runtime compatibility alias
oracle schedule remove <id>
oracle connect / oracle team
Connect agents on different machines to one project-scoped Remote Swarm.
# Runtime host
oracle daemon start --remote --host 0.0.0.0
oracle team token --project clew-code --agent worker-1 --role worker
oracle team token-revoke <token-id>
# Agent machine
oracle connect https://oracle.example.com \
--project clew-code --agent worker-1 --token "$ORACLE_SWARM_TOKEN"
oracle team status
oracle team agents
oracle team send --to lead --body "Ready"
oracle team inbox
oracle team ack <message-id>
oracle team watch
oracle team task create --title "Tests" --assignee worker-1 \
--checklist "tests pass"
oracle team task list --active
oracle team task update <id> --status in_progress --note "starting"
oracle team task check <id> 0
oracle team task submit <id> --summary "verified"
oracle team task close <id>
See Remote Swarm for deployment and security guidance.
oracle daemon
Persistent Runtime with SQLite coordination, Scheduler, HTTP APIs, and WebSocket events.
oracle daemon start [--port 4777]
oracle daemon start --remote --host 0.0.0.0 # explicit Remote Swarm binding
oracle daemon status [--json]
oracle daemon events [--after <event-id>]
oracle daemon stop
oracle daemon run # foreground mode
oracle control
Control Center TUI and local web dashboard.
oracle control # interactive TUI
oracle control --plain # dependency-free ANSI fallback
oracle control --once # render once and exit
oracle control --actor lead # record TUI decisions as lead
oracle control url # print authenticated dashboard URL
oracle control snapshot # JSON projection
oracle approval
Persistent human approval inbox.
oracle approval list [--status pending]
oracle approval show <id>
oracle approval request --title "Deploy" --requested-by builder \
--assigned-to lead --reviewers lead,security --quorum 2 \
--expires-in 30 --kind command --risk high --local-only
oracle approval approve <id> --by lead --note "verified"
oracle approval reject <id> --by lead --note "needs changes"
Tasks submitted for review appear automatically. Their decisions reuse the existing TaskStore and CoordinationService transition.
oracle swarm
Autonomous multi-agent swarm workflow.
oracle swarm create "Build the dashboard feature" \
--architect lead --coder builder --reviewer reviewer --qa tester
oracle swarm propose <workflow-id> builder "Implement the dashboard"
oracle swarm vote <proposal-id> reviewer approve "review passed"
oracle swarm vote <proposal-id> tester approve "tests passed"
oracle swarm status
oracle swarm recover
oracle audit
View agent audit trail and policy violations.
oracle audit show --limit 50
oracle audit violations
oracle audit verify
oracle audit verify --json
oracle identity
Manage your personal identity profile.
oracle identity setup
oracle identity show
oracle skill
Manage skills.
oracle skill list
oracle skill info <name>
oracle doctor
Verify installation, config, and provider health.
oracle doctor
oracle setup-mcp
Generate MCP config for a client.
oracle setup-mcp --client claude-code
oracle login / logout
OAuth authentication.
oracle login --provider anthropic
oracle logout --provider anthropic
oracle session
View consultation history.
oracle session <id>
oracle oracle
Manage oracle profiles (skill + model + memory bundles).
oracle oracle list
oracle oracle register --name coding --skill review --model auto
oracle github
GitHub integration via gh CLI (requires gh auth status).
oracle github pr list --repo owner/repo
oracle github pr get 42 --repo owner/repo
oracle github pr diff 42 --repo owner/repo
oracle github pr review 42 --repo owner/repo --approve
Oracle — A persistent coordination layer for AI coding agents https://github.com/OraclePersonal/Oracle