radioactive-ralph

A supervised-execution runtime for local AI-agent CLIs

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.

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.

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.