Release history
ralph-tui releases
Direct AI agents through task lists with autonomous execution.
All releases
17 shown
- 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
- 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
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.
- 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
- 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
- Honored sandbox when full-auto is enabled to enforce sandbox restrictions
- Added parallel execution system with branch-per-session workflow
- Introduced remote orchestration and smart parallelism heuristics
- Added Cursor agent support with enhancements
- --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
- 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
- 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
- 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
- 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
- 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
- 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
- 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