A helpful little guy with a lot of personalities.
radioactive-ralph is a binary-first repo runtime for AI-assisted development. It installs one executable, keeps one durable SQLite plan DAG, and lets you pick from ten built-in Ralph personas that control how the little guy thinks, acts, and spends effort.
radioactive_ralph service startis the durable repo runtime.radioactive_ralph run --variant <name>is the attached bounded runner.radioactive_ralph tuiis the socket-backed cockpit.- Fixit Ralph is the planning bridge when a repo has no active plan.
- Providers are configured in
.radioactive-ralph/config.tomlwith a repo-leveldefault_providerand named[providers.<name>]blocks.
The v1 shipped providers are claude, codex, and gemini. The runtime
model is broader: Ralph personas live in code, and repositories can bind any
compatible CLI provider once the prompt/model/effort/output contract is
defined.
| Platform | Command |
|---|---|
| macOS / Linux (Homebrew) | brew tap jbcom/pkgs https://github.com/jbcom/pkgs && brew install radioactive-ralph |
| Windows Scoop | scoop bucket add jbcom https://github.com/jbcom/pkgs && scoop install radioactive-ralph |
| Windows Chocolatey | choco install radioactive-ralph |
| macOS / Linux curl installer | curl -sSL https://jonbogaty.com/radioactive-ralph/install.sh |
radioactive_ralph init
radioactive_ralph run --variant fixit --advise \
--topic stabilize-runtime \
--description "stabilize the runtime and queue the next implementation pass"
radioactive_ralph plan ls
radioactive_ralph plan approvals
radioactive_ralph service startIf you want a bounded attached run instead of the durable service:
radioactive_ralph run --variant blue
radioactive_ralph run --variant grey
radioactive_ralph run --variant red
radioactive_ralph run --variant fixit
radioactive_ralph run --variant old-man --confirm-no-mercyVariants with infinite or long-running behavior require the durable service.
radioactive_ralph init
radioactive_ralph run --variant <name>
radioactive_ralph status
radioactive_ralph attach
radioactive_ralph stop
radioactive_ralph tui
radioactive_ralph doctor
radioactive_ralph service start
radioactive_ralph service install
radioactive_ralph service uninstall
radioactive_ralph service list
radioactive_ralph service status
radioactive_ralph plan ls
radioactive_ralph plan show <id-or-slug>
radioactive_ralph plan next <id-or-slug>
radioactive_ralph plan tasks <id-or-slug>
radioactive_ralph plan approvals
radioactive_ralph plan blocked
radioactive_ralph plan requeue <plan> <task>
radioactive_ralph plan retry <plan> <task>
radioactive_ralph plan handoff <plan> <task> <variant>
radioactive_ralph plan fail <plan> <task>
radioactive_ralph plan approve <id-or-slug> <task-id>
radioactive_ralph plan history <id-or-slug> <task-id>
radioactive_ralph plan import <path>
radioactive_ralph plan mark-done <id-or-slug> <task-id>| Surface | Role |
|---|---|
service start |
Durable repo-scoped runtime over the local control plane |
run --variant <name> |
Attached bounded execution for safe, finite variants |
tui |
Cockpit that attaches to the repo service or launches it if absent |
See AGENTS.md, STANDARDS.md, and docs/reference/testing.md.
go test ./...
golangci-lint run
python3 -m tox -e docsMIT. See LICENSE.