gitwtfhub

wtf is crucible?

dunkeln/crucible — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 3/5Setup · easy

TL;DR

Crucible is a Codex plugin that turns each AI coding attempt into a verified record of what was tried, checked, and worth keeping, instead of a disappearing chat log.

Mindmap

mindmap
  root((Crucible))
    What it does
      Attempt check evidence promotion
      Verifier required for reward
      Records failed attempts
    Tech stack
      Python
      Codex plugin
    Use cases
      Verified coding sessions
      Research data prep
      Training signal
    Roles
      Codex proposes
      Crucible checks
      Human promotes

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Keep a verifiable record of what an AI coding agent attempted, checked, and fixed during a task.

REASON 2

Give a future AI agent run prior failing evidence and a follow-up brief instead of starting from scratch.

REASON 3

Build a dataset of verified attempts and repairs for research, evaluation, or training purposes.

REASON 4

Reduce wasted tokens and cost on repeat AI coding sessions by reusing checked evidence.

What's in the stack?

PythonCodex

How it stacks up

dunkeln/crucible0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultyeasymoderatemoderate
Complexity3/52/54/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 30min

Installed as a Codex plugin via the Codex plugin marketplace, requires an existing Codex setup.

No license information is stated in the README.

Wtf does this do

Crucible is a plugin for Codex, an AI coding agent, that changes how the results of an agent's work session are kept and used afterward. Normally when an AI agent fixes a bug or completes a task, the details of that work disappear into a chat transcript once the session ends. Crucible instead turns each attempt into a structured record with four parts: the attempt itself, a check that verifies whether it actually worked, the evidence produced by that check, and a decision about whether to promote the result as something worth keeping. The core rule behind the project is that nothing counts as a success unless a verifier confirms it. A verifier is a test or check that stays close to the specific project, since the project itself is what defines what counts as correct. Even a failed attempt is treated as useful, because it shows exactly where the agent's approach diverged from what the verifier expected, and that failure becomes information a future attempt can learn from. The project includes a benchmark comparing a plain task folder against a Crucible-managed task pack that includes prior failing evidence and a follow-up brief. On this test, the Crucible-assisted run showed a meaningful drop in wasted input tokens and billable cost alongside a higher-quality output, with the verifier passing on the final result. Crucible is installed as a Codex plugin through Codex's plugin marketplace and then used directly inside the repository where the work is happening. Humans stay responsible for deciding what gets promoted or kept, while Codex can propose tasks, verifiers, and repairs, and Crucible runs the checks and records what happened.

Yoink these prompts

Prompt 1
Explain how Crucible's attempt, check, evidence, promotion loop works for a Codex coding session.
Prompt 2
Walk me through installing the Crucible plugin via the Codex plugin marketplace and running a first checked task.
Prompt 3
How does Crucible's verifier requirement decide whether an AI agent's attempt gets promoted or rejected?
Prompt 4
Summarize the benchmark comparing a plain Codex task folder against a Crucible-managed task pack.

Frequently asked questions

wtf is crucible?

Crucible is a Codex plugin that turns each AI coding attempt into a verified record of what was tried, checked, and worth keeping, instead of a disappearing chat log.

What language is crucible written in?

Mainly Python. The stack also includes Python, Codex.

What license does crucible use?

No license information is stated in the README.

How hard is crucible to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is crucible for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.