Super Oracle

A second-opinion oracle for coding agents, powered by Claude Fable in ultracode mode through the Claude Code CLI.

It ships as a skill (works in any agent with a shell) packaged as a plugin for Codex and Claude Code.

Prerequisites

• Claude Code installed and authenticated.
• Claude Code 2.1.203 or newer, which supports --model fable and --effort ultracode.
• A first-party Claude subscription session (claude auth login). Super Oracle ignores ANTHROPIC_API_KEY and never falls back to Anthropic API credits.
• claude on the PATH of the process running your agent. GUI-launched agents may not inherit the same PATH as your shell.

Verify the dependency before installing:

claude --version
printf 'Reply READY\n' | claude --dangerously-skip-permissions -p --effort ultracode --model fable

The wrapper always uses --dangerously-skip-permissions for unattended oracle runs. Use it only in trusted working directories and review any emitted changes.

Install

Codex CLI

codex plugin marketplace add parlance-labs/super-oracle
codex plugin add super-oracle@parlance-labs

Claude Code

claude plugin marketplace add parlance-labs/super-oracle
claude plugin install super-oracle@parlance-labs

Or inside Claude Code: /plugin marketplace add parlance-labs/super-oracle then /plugin install super-oracle@parlance-labs. Run /reload-plugins (or restart Claude Code) to activate it.

Amp (or any agent that uses SKILL.md)

Point the agent at the bundled skill:

git clone https://github.com/parlance-labs/super-oracle
# add to ~/.config/amp/settings.json:
#   "amp.skills.path": "/path/to/super-oracle/plugins/super-oracle/skills"

Or symlink plugins/super-oracle/skills/super-oracle into ~/.config/agents/skills/.

Use

Ask your agent to "use the super oracle" for a review, planning, debugging, or research task, or call the script directly:

plugins/super-oracle/skills/super-oracle/scripts/super-oracle.sh \
  -o oracle-out.md briefing.md

The wrapper feeds the briefing to Claude over stdin, captures the final response in -o, disables child skills to prevent recursive oracle calls, and avoids persisting the child session. See reference/briefing-template.md for an effective briefing.

Options

Every run fixes the model to Fable and ultracode mode (xhigh plus dynamic workflow orchestration). Hard calls can take minutes and use more tokens; the wrapper prints progress to stderr without contaminating the answer. It fails closed unless the debug stream confirms both Fable and ultracode's auto-mode gate. Set SUPER_ORACLE_REQUIRE_WORKFLOW=1 when a caller specifically needs to assert that a dynamic Workflow subagent ran.

License

MIT. See LICENSE.