radioactive-ralph

Binary-first orchestration for repository-local AI work

radioactive-ralph

A helpful little guy with many personalities: one binary, one plan store, one MCP surface, and a lot of Ralphspeaking.

Get started Meet the Ralphs Reference
Radioactive Ralph mascot

Start here

Getting started Install the binary, initialize a repo, register Claude MCP, and launch your first Ralph persona. Guides Learn how plans, fixit, safety floors, Claude MCP, cassettes, and launch checks 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.

  • Treats Claude Code as a client over stdio MCP, not as the product boundary.

  • Defines Ralph personas in code instead of outsourcing the canon to marketplace skills.

  • Keeps repo-root docs in docs/.

  • Leaves room for future provider bindings beyond claude.