radioactive-ralph#

A supervised-execution runtime for local AI-agent CLIs

radioactive-ralph

One binary, two modes: a supervisor that owns every agent's pty and the one durable database, and a dumb client that renders a read-only view of it.

Get started Reference
Radioactive Ralph mascot

Start here#

Getting started Install the binary, start the supervisor, register a project, and run the client. Guides Learn how the supervisor, client, plans, and providers 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.

  • The supervisor (--supervisor) owns every agent’s pty directly and never lets one block the system.

  • Stores durable plan, project, and spend state in one user-level SQLite database — never a per-repo file.

  • The client (no flag) discovers the supervisor and renders a read-only macro/meso/micro TUI.

  • Completion is orchestrator-verified against acceptance criteria, never a worker’s self-report.

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