ralph-tui
Run ralph-tui task loops for automated PRD execution. Covers headless mode, PRD preparation, agent selection (opencode/claude), session management, and troubleshooting. Use when asked to "run ralph-tui", "execute PRD tasks", or "start a ralph session".
npx skills add majiayu000/claude-skill-registry --skill ralph-tui-carmandale-agent-config --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Ralph-TUI Agent Execution Guide > A practical guide for AI agents running ralph-tui task loops ## Quick Start ```bash cd /path/to/project # Run ralph-tui (both agents work reliably) ralph-tui run --prd ./prd.json --agent opencode --headless --iterations 20 # or ralph-tui run --prd ./prd.json --agent claude --headless --iterations 20 # Monitor progress ralph-tui status --json | jq '{status, progress: .session.progress}' ``` ## Agent Selection **Both agents work reliably** when sessions are properly managed. | Agent | Speed | Notes | |-------|-------|-------| | `opencode` | ~5-10s/task | Lightweight, fast | | `claude` | ~20-30s/task | More verbose output, thorough | ```bash # OpenCode ralph-tui run --prd ./prd.json --agent opencode --headless # Claude ralph-tui run --prd ./prd.json --agent claude --headless ``` --- ## Prerequisites 1. **ralph-tui installed**: `which ralph-tui` 2. **Agent CLI installed**: `opencode` or `claude` 3. **PRD file**: JSON format with user stories --- ## Preparing a PRD ### Option 1: Create PRD Interactively ```bash ralph-tui create-prd # or with AI chat assistance: ralph-tui create-prd --chat ``` ### Option 2: Convert Markdown to JSON ```bash ralph-tui co
- Quick Start
- Agent Selection
- Prerequisites
- Preparing a PRD
- Option 1: Create PRD Interactively
- Option 2: Convert Markdown to JSON
- Option 3: Manual JSON Structure
- Key PRD Fields
- The .ralph-tui/ Directory
- Running Ralph-TUI
- Standard Execution
- Check Status
- Resume Interrupted Session
- Session Management
cd /path/to/project
Run ralph-tui (both agents work reliably)
ralph-tui run --prd ./prd.json --agent opencode --headless --iterations 20
or
ralph-tui run --prd ./prd.json --agent claude --headless --iterations 20
Monitor progress
ralph-tui status --json | jq '{status, progress: .session.progress}'
OpenCode
ralph-tui run --prd ./prd.json --agent opencode --headless
ClaudeWhat does the ralph-tui skill do?
Run ralph-tui task loops for automated PRD execution. Covers headless mode, PRD preparation, agent selection (opencode/claude), session management, and troubleshooting. Use when asked to "run ralph-tui", "execute PRD tasks", or "start a ralph session".
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill ralph-tui-carmandale-agent-config --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.
