GEN 2Active

RALPHUSSY

The Autonomous AI Coding Toolbelt.

Ralphussy is the Gen 2 Ussyverse agent — a comprehensive CLI + TUI suite for autonomous software development. It processes DevPlan task lists iteratively, supports parallel execution via swarm mode, and provides a full terminal UI for monitoring agent progress. The bridge between Swarmussy's chaos and Geoffrussy's polish.

Built With

Shell/BashPythonJavaScriptJinja TemplatesMultiple LLM ProvidersMIT License

CLI Agent (ralph2)

Autonomous loop-based coding agent. Give it a task, and it iteratively plans, codes, tests, and refines until the task is complete.

Terminal UI (ralph-tui)

Interactive Python TUI for monitoring agent progress, managing sessions, and viewing real-time output. Full mouse and keyboard support.

Swarm Mode

Parallel task execution using multiple workers on isolated project copies. Process a full DevPlan with concurrent agents.

DevPlan Workflow

Processes Markdown task lists (DevPlans), marking items complete as work progresses. State persists between sessions.

Multi-Provider Support

Supports Anthropic, OpenAI, OpenRouter, and Ollama. Granular model selection per pipeline stage (planning vs execution).

Persistent Configuration

Settings menu with saved preferences. Choose different models for different stages, configure behavior, and persist across sessions.

Where Ralphussy Fits

Ralphussy evolved from Swarmussy (Gen 1) by adding structured planning and a proper TUI. It introduced the concept of DevPlan-driven development — give the agent a Markdown task list, and it works through it systematically.

As a Bash + Python hybrid, Ralphussy proved the autonomous agent concept but hit architectural limits. The need for a clean, compiled, single-binary distribution led toGeoffrussy (Gen 3), which rewrites the core in Go while keeping Ralphussy's best ideas.

Ralphussy is still actively maintained (last updated January 2026) and remains useful for developers who prefer a shell-native workflow over Go.