radioactive-ralph

Binary-first runtime for repository-local AI work

radioactive-ralph

A helpful little guy with many personalities: one binary, one plan DAG, one durable repo service, and one cockpit.

Get started Meet the Ralphs Reference

Start here

Getting started Install the binary, initialize a repo, let Fixit seed the plan DAG, and launch the repo service. Guides Learn how plans, Fixit, providers, safety floors, and the service/TUI flow fit together. Reference Read the current architecture, implementation state, testing stance, and generated Go API reference.

What Ralph does

• Runs as a single Go binary: radioactive_ralph.

• Stores durable plan state in SQLite and executes it through a repo-local service.

• Exposes three operator surfaces: service start, run --variant, and tui.

• Defines Ralph personas in code instead of duplicating the canon in external sidecar specs.

• Treats the provider as a binding, not the product boundary.