subsy/ralph-tui

Ralph TUI is a terminal user interface for orchestrating AI coding agents to work through task lists autonomously.

The tool solves the problem of manually managing AI agents across multiple coding tasks by automating the loop of task selection, agent execution, and completion detection. It connects to AI coding assistants such as Claude Code, OpenCode, Factory Droid, Cursor CLI, Gemini CLI, Codex, and Kiro CLI, and integrates with task trackers including prd.json and Beads. Ralph selects the highest-priority task, builds a prompt, executes the configured agent, detects when work is complete, and repeats until all tasks are finished. The tool provides real-time visibility into agent output and allows users to control execution through keyboard shortcuts.

Ralph TUI suits teams and individual developers who want to delegate repetitive coding work to AI agents while maintaining oversight and control. It works well for projects that already use structured task tracking and have a preferred AI coding assistant. The tool distinguishes itself by supporting multiple agent and tracker integrations, offering session persistence so work can be paused and resumed, and providing subagent tracing to see nested agent calls in real time. It also enables cross-iteration context to track progress automatically between tasks and supports remote instances, allowing monitoring and control of multiple Ralph TUI sessions from a single interface.

The project maintains active engagement with its user base, with most open issues coming from outside users rather than the core team, indicating a substantial base of real-world adopters. Maintainers typically respond to new issues and pull requests within a day. Work in the issue tracker is dominated by bug reports, enhancement requests, and user questions.