# subsy/ralph-tui

Repository: https://github.com/subsy/ralph-tui
Canonical: https://ross.abutalabs.com/products/ralph-tui
Homepage: https://ralph-tui.com
Language: TypeScript
License: MIT
License Family: permissive
Last push: 2026-08-26T10:03:11+00:00

## Health v2 (maintenance only)
Score: 77/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 83, longevity 16
- inputs: {"age_days": 234, "days_push": 7, "days_rel": 112, "gap_med": 2.0, "n_releases_24m": 17}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2428, forks 234 (observed 2026-08-28T04:06:50.926167+00:00)

## What it is
Ralph TUI is an AI Agent Loop Orchestrator delivered as a terminal UI (TUI) that runs AI coding agents like Claude Code, OpenCode, and Factory Droid autonomously through task lists. It connects agents to task trackers (prd. or Beads), cycling through selecting tasks, building prompts from Handlebars templates, executing agents, and detecting completion until the backlog is done.

## Use cases
- run AI coding agents autonomously through a task list
- orchestrate Claude Code or OpenCode to complete tasks one by one
- generate a PRD and break it into atomic tasks with AI
- automate the select-prompt-execute-evaluate loop for coding agents
- work through a backlog of coding tasks without manual prompting
- turn a product requirements document into dependency-aware tasks

## When to choose
- you want an autonomous loop that feeds tasks to AI coding CLIs like Claude Code, OpenCode, or Factory Droid
- you prefer a terminal UI with real-time agent output and full visibility
- you want AI-assisted PRD creation and dependency-aware task breakdown
- you use prd. or Beads as your task tracker and want zero-friction JSON mode

## When to avoid
- you need a GUI or web-based agent orchestration dashboard
- your workflow relies on agents or task trackers not supported by Ralph's plugin system
- you want fully unattended CI-style execution rather than an interactive terminal session
- you don't use Bun or don't want a Node/Bun-based toolchain

## Facets
- artifact type: cli-tool
- maturity: active
- function: agent-framework, cli, workflow-automation, prompt-engineering, terminal-ui
- domain: developer-tools, large-language-models
- platform: cli, bun, cross-platform, windows
- tags: ai-agent-orchestration, autonomous-coding-agents, tui, task-loop, claude-code, opencode, prd, handlebars-templates, ai-agents, automation, command-line, nodejs, macos, linux

## Member repositories
- subsy/ralph-tui (main) score 77

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:50.926167+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:31:34.153498+00:00, confidence not recorded.
  - readme: https://github.com/subsy/ralph-tui (fetched 2026-08-28T04:06:50.926167+00:00, sha e2f177ba18af)
  - homepage: https://ralph-tui.com (fetched 2026-08-29T10:13:13.980758+00:00, sha 875d4993a5c4)
  - site_page: https://ralph-tui.com/docs (fetched 2026-08-29T10:13:13.989908+00:00, sha 12e224665633)
  - site_page: https://ralph-tui.com/docs/getting-started/introduction (fetched 2026-08-29T10:13:13.991949+00:00, sha 481e08f76cdc)
  - site_page: https://ralph-tui.com/docs/getting-started/quick-start (fetched 2026-08-29T10:13:13.993832+00:00, sha 93ceb791a122)
  - registry_npm: https://registry.npmjs.org/ralph-tui (fetched 2026-08-29T10:13:13.996552+00:00, sha 79b07300db40)
- Data as of 2026-08-30T08:39:29.467469+00:00.