Skip to content

Release history

ralph-tui releases

Direct AI agents through task lists with autonomous execution.

All releases

17 shown

No immediate action
v0.12.0 New feature

Configurable timeouts + TUI remote mode

v0.11.0 New feature
Notable features
  • Runtime toggle for auto-commit setting via the TUI
  • Enforced Bun runtime version minimum at 1.3.6
  • Stabilized dotted child task ordering across beads trackers
v0.10.0 New feature
Notable features
  • Dependency ID enrichment for parallel execution
  • Live task usage/context telemetry
  • Symlinked skill discovery support
Full changelog

What's Changed

  • Update Beads-BV tracker documentation with correct repository link by @subsy in https://github.com/subsy/ralph-tui/pull/322
  • fix(beads-rust): enrich getTasks with dependency IDs for parallel execution by @thunter009 in https://github.com/subsy/ralph-tui/pull/321
  • fix(beads): enrich dependency IDs for parallel graph analysis by @subsy in https://github.com/subsy/ralph-tui/pull/323
  • fix: support symlinked skill discovery and robust install agent counting by @subsy in https://github.com/subsy/ralph-tui/pull/325
  • Add live task usage/context telemetry and aggregate usage metrics by @subsy in https://github.com/subsy/ralph-tui/pull/326
  • chore: bump version to 0.10.0 by @subsy in https://github.com/subsy/ralph-tui/pull/324

Full Changelog: https://github.com/subsy/ralph-tui/compare/v0.9.0...v0.10.0

v0.9.0 Bug fix

Fixed a data-loss bug in Beads sync, stabilized parallel worktree handling, and introduced a Kimi CLI agent plugin, improving reliability and extensibility for users.

v0.8.0 New feature
Notable features
  • AI conflict resolution for parallel execution
  • Image attachment support for create-prd
  • GitHub Copilot agent plugin
Full changelog

What's Changed

  • feat: wire up AI conflict resolution for parallel execution by @subsy in https://github.com/subsy/ralph-tui/pull/283
  • feat(images): Add image attachment support for create-prd by @jesse-merhi in https://github.com/subsy/ralph-tui/pull/195
  • fix(oom): cap output buffers to stop 96GB memory blowups by @dyxushuai in https://github.com/subsy/ralph-tui/pull/288
  • fix: filter tombstoned issues from beads-rust tracker by @thunter009 in https://github.com/subsy/ralph-tui/pull/297
  • Fix beads-rust epic filtering and parallel config loading by @dvic in https://github.com/subsy/ralph-tui/pull/300
  • fix(agents): resolve explicit command paths during detection by @subsy in https://github.com/subsy/ralph-tui/pull/302
  • fix: handle parallel disk space fallback and expose startup failures by @subsy in https://github.com/subsy/ralph-tui/pull/303
  • Fix custom agents missing in settings (issue 287) by @subsy in https://github.com/subsy/ralph-tui/pull/304
  • feat: added github copilot agent plugin by @cachemoney in https://github.com/subsy/ralph-tui/pull/286
  • chore: bump version to 0.8.0 and update next-mdx-remote by @subsy in https://github.com/subsy/ralph-tui/pull/305

New Contributors

  • @thunter009 made their first contribution in https://github.com/subsy/ralph-tui/pull/297
  • @dvic made their first contribution in https://github.com/subsy/ralph-tui/pull/300
  • @cachemoney made their first contribution in https://github.com/subsy/ralph-tui/pull/286

Full Changelog: https://github.com/subsy/ralph-tui/compare/v0.7.1...v0.8.0

v0.7.1 Mixed
Notable features
  • Parallel execution and progress file configuration schemas
  • Conflict resolution callbacks
Full changelog

What's Changed

  • Add parallel execution and progress file configuration schemas by @subsy in https://github.com/subsy/ralph-tui/pull/280
  • Fix theme directory path for bun bundler flat output by @subsy in https://github.com/subsy/ralph-tui/pull/279
  • Remove PRD link inclusion from bead conversion by @subsy in https://github.com/subsy/ralph-tui/pull/282
  • Fix prompt preview pane flickering by @subsy in https://github.com/subsy/ralph-tui/pull/270
  • Add conflict resolution callbacks to parallel execution UI by @subsy in https://github.com/subsy/ralph-tui/pull/281

Full Changelog: https://github.com/subsy/ralph-tui/compare/v0.7.0...v0.7.1

v0.7.0 New feature
Security fixes
  • Honored sandbox when full-auto is enabled to enforce sandbox restrictions
Notable features
  • Added parallel execution system with branch-per-session workflow
  • Introduced remote orchestration and smart parallelism heuristics
  • Added Cursor agent support with enhancements
v0.6.0 Mixed
Notable features
  • --theme CLI option for custom color schemes
  • Bundled theme names for simplified usage
  • Centralized agent configuration resolution
Full changelog

What's Changed

  • Centralize agent configuration resolution logic by @subsy in https://github.com/subsy/ralph-tui/pull/229
  • Fix file handling on Windows for session registry by @subsy in https://github.com/subsy/ralph-tui/pull/228
  • Use HEREDOC syntax for safe bead description handling by @subsy in https://github.com/subsy/ralph-tui/pull/227
  • feat: add --theme CLI option for custom color schemes by @esumerfd in https://github.com/subsy/ralph-tui/pull/217
  • Remove progress file writing, keep reading for context by @subsy in https://github.com/subsy/ralph-tui/pull/226
  • Use br dep list instead of br show for parent-child filtering by @subsy in https://github.com/subsy/ralph-tui/pull/230
  • feat: simplify theme usage with bundled theme names by @subsy in https://github.com/subsy/ralph-tui/pull/231

New Contributors

  • @esumerfd made their first contribution in https://github.com/subsy/ralph-tui/pull/217

Full Changelog: https://github.com/subsy/ralph-tui/compare/v0.5.0...v0.6.0

v0.5.0 Bug fix
Notable features
  • Environment variable passthrough allowlist for blocked vars
  • Tracker labels support in PRD creation
Full changelog

What's Changed

  • Replace XML tags with markdown formatting in chat prompts by @subsy in https://github.com/subsy/ralph-tui/pull/205
  • Add environment variable passthrough allowlist for blocked vars by @subsy in https://github.com/subsy/ralph-tui/pull/207
  • Fix Windows shell execution with paths containing spaces by @subsy in https://github.com/subsy/ralph-tui/pull/211
  • Delegate skills installation to Vercel's add-skill CLI by @subsy in https://github.com/subsy/ralph-tui/pull/209
  • Add tracker labels support to PRD creation workflow by @subsy in https://github.com/subsy/ralph-tui/pull/208
  • Fix Claude Code sandbox environment on Linux VMs by @subsy in https://github.com/subsy/ralph-tui/pull/210
  • chore: bump version to 0.5.0 by @subsy in https://github.com/subsy/ralph-tui/pull/213

Full Changelog: https://github.com/subsy/ralph-tui/compare/v0.4.0...v0.5.0

v0.4.0 New feature
Notable features
  • PRD context support for beads and JSON trackers
  • beads-rust tracker plugin
  • Gemini CLI, Codex, and Kiro CLI agent plugins
Full changelog

What's Changed

  • docs: Fix tasks.json example by @ArnaudRinquin in https://github.com/subsy/ralph-tui/pull/164
  • feat: add PRD context support to beads and JSON trackers by @subsy in https://github.com/subsy/ralph-tui/pull/168
  • feat: beads-rust tracker plugin and improvements by @subsy in https://github.com/subsy/ralph-tui/pull/179
  • feat: add Gemini CLI, Codex, and Kiro CLI agent plugins by @medhatgalal in https://github.com/subsy/ralph-tui/pull/170
  • feat: auto-scroll output window to show latest output during task execution by @subsy in https://github.com/subsy/ralph-tui/pull/186
  • fix(opencode): implement line buffering for reliable JSON parsing by @put101 in https://github.com/subsy/ralph-tui/pull/185
  • fix(chat): change default timeout to 0 (no timeout) by @subsy in https://github.com/subsy/ralph-tui/pull/188
  • fix: use conditional shell in runVersion for claude and opencode agents by @subsy in https://github.com/subsy/ralph-tui/pull/187
  • feat: show task dependencies in iteration detail view (Issue #180) by @subsy in https://github.com/subsy/ralph-tui/pull/189
  • feat: add envExclude option to filter environment variables for agents by @subsy in https://github.com/subsy/ralph-tui/pull/190
  • fix: pass command config to agent in create-prd and doctor commands by @Unravl in https://github.com/subsy/ralph-tui/pull/191
  • Load bead labels from config.toml instead of hardcoding 'ralph' by @subsy in https://github.com/subsy/ralph-tui/pull/193
  • Add interactive terminal detection to setup wizard by @subsy in https://github.com/subsy/ralph-tui/pull/196
  • Add cross-directory session resume via global registry by @subsy in https://github.com/subsy/ralph-tui/pull/192
  • Add support for Apple Silicon Homebrew installation paths by @subsy in https://github.com/subsy/ralph-tui/pull/199
  • feat: implement autoCommit engine behavior for task completion by @subsy in https://github.com/subsy/ralph-tui/pull/198
  • feat(kiro): fix PRD creation and add model selection by @medhatgalal in https://github.com/subsy/ralph-tui/pull/194
  • Improve user story description parsing for multiple LLM formats by @subsy in https://github.com/subsy/ralph-tui/pull/200
  • chore: bump version to 0.4.0 by @subsy in https://github.com/subsy/ralph-tui/pull/201

New Contributors

  • @ArnaudRinquin made their first contribution in https://github.com/subsy/ralph-tui/pull/164
  • @medhatgalal made their first contribution in https://github.com/subsy/ralph-tui/pull/170
  • @put101 made their first contribution in https://github.com/subsy/ralph-tui/pull/185
  • @Unravl made their first contribution in https://github.com/subsy/ralph-tui/pull/191

Full Changelog: https://github.com/subsy/ralph-tui/compare/v0.3.0...v0.4.0

v0.3.0 New feature
Notable features
  • Remote instance monitoring and control
  • Improved first-time user experience
  • OpenCode prompt via stdin for Windows compatibility
Full changelog

What's Changed

  • fix: info command version detection, skills display, and documentation updates by @subsy in https://github.com/subsy/ralph-tui/pull/149
  • feat(ux): improve first-time user experience by @subsy in https://github.com/subsy/ralph-tui/pull/155
  • feat: Remote Instance Monitoring and Control by @subsy in https://github.com/subsy/ralph-tui/pull/157
  • fix: pass OpenCode prompt via stdin to avoid Windows shell interpretation by @subsy in https://github.com/subsy/ralph-tui/pull/159

Full Changelog: https://github.com/subsy/ralph-tui/compare/v0.2.1...v0.3.0

v0.2.1 New feature
Notable features
  • ralph-tui info command for troubleshooting
  • ralph-tui skill install command
  • Multi-agent skill installation with agent-specific folders
Full changelog

What's New

Features

Feat: 'ralph-tui info' command to assist troubleshooting
Feat: 'ralph-tui skill install' command for re-installation of skills
Feat: Multi-agent skill installation - agent plugins now declare their specific skills folders and ralph-tui will offer to install to those specific folders. Bonus - this also fixes skills for Factory Droid
Feat: TAB switches focus between Task list and Agent Tree panel
Feat: Subagent output now displayed in output view when subagent selected

Fixes

Fix: Skills installing to project folder instead of global config folder in some situations
Fix: 'ralph-tui-create-json' skill sometimes generating json output with incorrect schema

v0.2.0 New feature
Notable features
  • Sandboxing with bubblewrap/sandbox-exec
  • New agent output parser with TUI-native rendering
  • Custom executable support for agent wrappers
Full changelog

What's New

Features

  • Sandboxing - run all your agents in sandboxes for host FS isolation (bubblewrap on linux / WSL, sandbox-exec on mac)
  • New agent output parser with TUI-native rendering, more granular output and colour coding
  • Refactored prompt templates system with global templates and project-specific overrided.
  • Revised prompts that improve token usage
  • Added new prompt preview panel ('o' will now cycle through views - details -> output -> prompt)
  • Pressing 's' when stopped/idle will add +1 iterations if at max
  • Enabled clipboard copy in both create-prd mode and ralph loop mode
  • Define custom executable for an agent (enable use of agent wrappers like CC Router)
  • Added --variant flag / config option to call model with different thinking depths
  • Added pre-flight system to catch common ralph-tui and agent configuration issues
  • 'ralph-tui doctor' to detect and diagnose config issues

Bug Fixes

  • Incorrect detection of provider rate-limit when agent-output included @upstash/ratelimit
  • Skills not installing
  • beads tracker plugin not picking next-best task
  • beads tracker plugin issues not closing
  • Droid agent plugin not working on OS X
  • Iteration output for completed steps will now correctly show the agent/model used for that step

Misc

  • Improve test coverage
  • Refactor to package prompt templates with tracker plugins

New Contributors

  • @feyleth made their first contribution in https://github.com/subsy/ralph-tui/pull/80
  • @jesse-merhi made their first contribution in https://github.com/subsy/ralph-tui/pull/86
  • @sambostock made their first contribution in https://github.com/subsy/ralph-tui/pull/89
  • @carmandale made their first contribution in https://github.com/subsy/ralph-tui/pull/119
  • @manascb1344 made their first contribution in https://github.com/subsy/ralph-tui/pull/123
v0.1.7 New feature
Notable features
  • Factory Droid agent plugin support
  • TTY handling via pseudo-TTY wrapper
  • JSONL output parsing with cost tracking
Full changelog

What's New

Factory Droid Agent Integration

  • Added Factory Droid (droid) as a supported agent plugin
  • TTY handling via pseudo-TTY wrapper for Ink-based CLI compatibility
  • JSONL output parsing with cost tracking and event filtering

Documentation

  • Updated agent plugin docs for Claude, Droid, and OpenCode
  • Clarified autonomous operation mode (always enabled for ralph-tui)

Bug Fixes

  • Fixed droid agent shell escaping and argument ordering
  • Fixed output parser to correctly detect agent type from CLI flags
  • Various stability improvements
0.1.4 New feature
Notable features
  • Runtime iteration adjustment with +/= and -/_ keys
  • Iteration counter in TUI header [current/max]
  • Auto-restart when adding iterations
Full changelog

Release 0.1.4

Features

  • Runtime iteration adjustment - Add/remove iterations while Ralph is running using +/= and -/_ keys
  • Iteration counter displayed in TUI header: [current/max]
  • Auto-restart when adding iterations after hitting max

Contributors

  • @tajquitgenius - Runtime iteration controls feature

Beta — feedback welcome: [email protected]