oraculum

English | 한국어

Oraculum

Generate competing patches. Judge them. Promote only the survivors.
_{Patch search and judgment harness for Claude Code and Codex}

Overview · Installation · Quick Start · How It Works · Advanced Usage

Overview

Oraculum is a local installable workflow tool that sits between your codebase and an AI coding runtime.

Instead of trusting the first patch an AI gives you, Oraculum tries multiple candidate fixes, checks them, and helps you keep only the survivors.

Installation

Install the current beta:

npm install -g oraculum@beta

Quick Start

From the project folder:

oraculum consult "fix session loss on refresh"
oraculum promote --branch fix/session-loss

That is the default flow. consult initializes Oraculum on first use, runs the tournament, and prints the result summary immediately. promote uses the latest promotable consultation and its recommended promotion by default.

In a Git-backed project, promote creates the branch and applies the winner there. In a non-Git project, it syncs the winner back into the project folder.

If you want to reopen the latest consultation later, inspect an older one, or browse consultation history, see Advanced Usage.

How It Works

• You give Oraculum one task.
• Oraculum creates multiple candidate fixes.
• Each candidate runs in its own workspace.
• Checks remove weak candidates in stages.
• Oraculum recommends a survivor, explains the comparison, and lets you promote it.

Results are saved under .oraculum/. The source of truth is the saved run state and artifacts, not chat transcript.

Advanced Usage

If you want more control over consultation-scoped profile selection, runtimes, candidate counts, specific consultation IDs, report packaging, repo-local oracle configuration, or manually overriding the recommended promotion, see Advanced Usage. Quick-start defaults live in .oraculum/config.json; operator controls belong in .oraculum/advanced.json.