Ralph TUI

Ralph TUI is a terminal-based AI agent loop orchestrator designed to automate your entire development workflow. It manages autonomous coding agents through intelligent task routing and continuous execution, allowing you to ship faster with minimal manual intervention.

Planning Phase: Start by creating comprehensive Product Requirements Documents through interactive AI collaboration. Ralph TUI guides you through natural language feature descriptions, generates clarifying questions with smart defaults, structures user stories with acceptance criteria, and automatically defines scope boundaries.

Execution Loop: The orchestrator runs a continuous four-step cycle:

• Select: Pick the next task from your issue tracker based on priority and dependencies
• Prompt: Generate smart prompts from customizable templates with minimal context injection
• Execute: Run autonomous AI coding agents with real-time progress monitoring
• Evaluate: Analyze output to determine completion status and trigger next actions

Key Capabilities:

• Multiple task tracker integration (JSON files, Beads, Beads-BV)
• Support for Claude Code, OpenCode, and custom AI agent plugins
• Custom Handlebars prompt templates with context injection
• Automatic session persistence and state recovery
• Real-time TUI dashboard for monitoring progress
• Subagent tracing for debugging nested agent calls
• Intelligent dependency resolution and parallel execution scheduling
• CLI-first design optimized for terminal power users

Install with bun install -g ralph-tui and start automating your development workflow in minutes.