Improved

• Bump golang.org/x/term from 0.44.0 to 0.45.0 #409 @dependabot
• Bump golang.org/x/sys from 0.46.0 to 0.47.0 #408 @dependabot
• Bump golang.org/x/net from 0.53.0 to 0.55.0 #401 @dependabot

Fixed

• Clean codex review output and surface claude subagent progress #417 @umputun
• Align default review agents with the review-loop contract #414 @alekb
• Refresh claude and codex at container start (opt-in) #413 @umputun
• Skip regenerable plugin-manager state when seeding container #405 @umputun
• Preserve wrapper file mode on --update-script #404 @umputun
• Bound force-exit cleanup so a stuck worktree removal cannot prevent exit #400 @paskal
• Skip 65MB parse test under -race to unhang go test -race ./pkg/web #399 @paskal
• Tolerate coveralls upload failures in CI 032776c

Improved

• Bump golang.org/x/term from 0.44.0 to 0.45.0 #409 @dependabot
• Bump golang.org/x/sys from 0.46.0 to 0.47.0 #408 @dependabot
• Bump golang.org/x/net from 0.53.0 to 0.55.0 #401 @dependabot

Fixed

• Clean codex review output and surface claude subagent progress #417 @umputun
• Align default review agents with the review-loop contract #414 @alekb
• Refresh claude and codex at container start (opt-in) #413 @umputun
• Skip regenerable plugin-manager state when seeding container #405 @umputun
• Preserve wrapper file mode on --update-script #404 @umputun
• Bound force-exit cleanup so a stuck worktree removal cannot prevent exit #400 @paskal
• Skip 65MB parse test under -race to unhang go test -race ./pkg/web #399 @paskal
• Tolerate coveralls upload failures in CI 032776cc

v1.6.1 Latest

Latest

Compare

Choose a tag to compare

New Features

• Surface the reason when ralphex refuses to run #392 @umputun
• Install latest fya in base docker image #390 @umputun
• Add new Anthropic model Fable to supported agent models #384 @Alex-Kopylov
• Display user-set run parameters (models, executor) in web dashboard #382 @vlondon
• Add pi provider support (wrapper + skills) #378 @olomix

Improvements

• Bump actions/checkout from 6 to 7 #391 @dependabot
• Bump golang.org/x/term from 0.43.0 to 0.44.0 #389 @dependabot
• Bump golang.org/x/sys from 0.45.0 to 0.46.0 #388 @dependabot
• Bump gopkg.in/ini.v1 from 1.67.2 to 1.67.3 #387 @dependabot

Bug Fixes

• Plan panel marks finished tasks done and scrolls to the active task #383 @vlondon

New Features

• Surface the reason when ralphex refuses to run #392 @umputun
• Install latest fya in base docker image #390 @umputun
• Add new Anthropic model Fable to supported agent models #384 @Alex-Kopylov
• Display user-set run parameters (models, executor) in web dashboard #382 @vlondon
• Add pi provider support (wrapper + skills) #378 @olomix

Improved

• Bump actions/checkout from 6 to 7 #391 @dependabot
• Bump golang.org/x/term from 0.43.0 to 0.44.0 #389 @dependabot
• Bump golang.org/x/sys from 0.45.0 to 0.46.0 #388 @dependabot
• Bump gopkg.in/ini.v1 from 1.67.2 to 1.67.3 #387 @dependabot

Fixed

• Plan panel marks finished tasks done and scrolls to the active task #383 @vlondon

v1.6.0

Compare

Choose a tag to compare

Bug Fixes

• retry transient HTTP errors (529/502/503/504) without --wait #377 @umputun

Fixed

• Retry transient HTTP errors (529/502/503/504) without --wait #377 @umputun

v1.5.1

Compare

Choose a tag to compare

New Features

• Add claude_retry_patterns for transient wrapper timeouts #374 @umputun

New Features

• Add claude_retry_patterns for transient wrapper timeouts #374 @umputun

v1.5.0

Compare

Choose a tag to compare

New Features

• Add Antigravity (agy) CLI wrapper as custom provider #369 @korjavin
• Add plan model setting #363 @umputun

Improved

• Refactor processor runner into phase engines #364 @umputun
• Cut code smells and duplication across packages #373 @umputun
• Standardize date format on YYYYMMDD- in prompts and skill #371 @umputun
• Document codex plan creation 07a4cc7
• Clarify Claude wrapper compatibility a3c9157
• Use GitHub warning alert d9e4744
• Document Claude Agent SDK billing options 3f8b89f
• Bump golang.org/x/sys from 0.44.0 to 0.45.0 #360 @dependabot

Fixed

• Pass model and effort flags #372 @mschedrin
• Validate model flag values #372 @mschedrin

New Features

• Add Antigravity (agy) CLI wrapper as custom provider #369 @korjavin
• Add plan model setting #363 @umputun

Improved

• Refactor processor runner into phase engines #364 @umputun
• Cut code smells and duplication across packages #373 @umputun
• Standardize date format on YYYYMMDD- in prompts and skill #371 @umputun
• Document codex plan creation 07a4cc75
• Clarify Claude wrapper compatibility a3c9157f
• Use GitHub warning alert d9e47442
• Document Claude Agent SDK billing options 3f8b89fa
• Bump golang.org/x/sys from 0.44.0 to 0.45.0 #360 @dependabot

Fixed

• Pass model and effort flags #372 @mschedrin
• Validate model flag values #372 @mschedrin

v1.4.0

Compare

Choose a tag to compare

Improvements

• retry claude 5xx API errors via limit patterns 810840f
• dedup CLAUDE.md against llms.txt to clear size threshold b858c05
• trim CLAUDE.md verbosity a4853c7

Bug Fixes

• detect Claude session-limit message #362 @umputun

Improved

• Retry claude 5xx API errors via limit patterns 810840f
• Dedup CLAUDE.md against llms.txt to clear size threshold b858c05
• Trim CLAUDE.md verbosity a4853c7

Fixed

• Detect Claude session-limit message #362 @umputun

v1.3.2

Compare

Choose a tag to compare

New Features

• per-phase model selection for codex executor #357 @umputun

Improvements

• reflect codex executor support in README header 15b35c7
• reflect codex executor support on landing page 88c3966

New Features

• Per-phase model selection for codex executor #357 @umputun

Improved

• Reflect codex executor support in README header 15b35c7
• Reflect codex executor support on landing page 88c3966

v1.3.1

Compare

Choose a tag to compare

New Features

• Add first-class codex executor mode #350 @umputun

Improved

• Add External-Only Mode section to README #345 @umputun
• Bump github.com/slack-go/slack from 0.23.0 to 0.23.1 #347 @dependabot

New Features

• Add first-class codex executor mode #350 @umputun

Improved

• Add External-Only Mode section to README #345 @umputun
• Bump github.com/slack-go/slack from 0.23.0 to 0.23.1 #347 @dependabot

v1.3.0

Compare

Choose a tag to compare

New Features

• detect org's monthly usage limit in claude output #338 @umputun
• add preserve_anthropic_api_key option for API-key auth (#333) #335 @rsolmano

Improvements

• document tool-swap setup and list missing wrappers 6d3c63d
• bump golang.org/x/sys from 0.43.0 to 0.44.0 #340 @dependabot
• bump golang.org/x/term from 0.42.0 to 0.43.0 #339 @dependabot

Bug Fixes

• tolerate plan file rename during execution #342 @umputun
• pre-initialize config dir #304 @Semior001

New Features

• Detect org's monthly usage limit in claude output #338 @umputun
• Add preserve_anthropic_api_key option for API-key auth (#333) #335 @rsolmano

Improved

• Document tool-swap setup and list missing wrappers 6d3c63d
• Bump golang.org/x/sys from 0.43.0 to 0.44.0 #340 @dependabot
• Bump golang.org/x/term from 0.42.0 to 0.43.0 #339 @dependabot

Fixed

• Tolerate plan file rename during execution #342 @umputun
• Pre-initialize config dir #304 @Semior001

v1.2.0

Compare

Choose a tag to compare

Improvements

• update all dependencies c43c5c0

Bug Fixes

• ignore checkboxes inside fenced code blocks in plan parser #329 @umputun

Improved

• Update all dependencies c43c5c0

Fixed

• Ignore checkboxes inside fenced code blocks in plan parser #329 @umputun

v1.1.1

Compare

Choose a tag to compare

New Features

• Add --branch flag to override worktree/branch name #315 @bronislav
• Add provider override CLI flags (--claude-command, --external-review-tool) #314 @korjavin
• Add /ralphex-adopt skill for converting plans from other formats into ralphex format #313 @umputun
• Add move_plan_on_completion config option #307 @bronislav
• Add --image and --port CLI flags to docker wrapper #301 @umputun
• Also retry admin-disabled allocation on wait_on_limit 7571c70

Improved

• Migrate docs site from mkdocs-material to zensical 90becf9
• Rework landing copy and add FAQ to capture ralph-loop search traffic 96fe10a
• Fix plugin install command in README and llms.txt #323 @umputun
• Drop goconst linter check 710b297

Fixed

• Tighten default codex error/limit patterns to avoid false positives on codebases that talk about rate limits #324 @umputun
• Detect admin-disabled usage allocation in claude output #319 @umputun
• Progress log filename ignores --branch override #316 @bronislav
• Trigger --wait retry on codex stderr-only quota errors #311 @umputun
• Resume watch-mode tailing after flock race marks session completed #305 @umputun
• Keep task section headers in English for localized plans #302 @umputun
• Prevent flag/option names from wrapping in table first column e3622c1

Fixed

• Also pass TZ env var in Docker wrapper so Go's time.Now() respects the host timezone (previously only TIME_ZONE was forwarded, which baseimage consumes but Go ignores) #297 @umputun

First stable release. From this point forward, ralphex follows Semantic Versioning with a backward compatibility promise for the public surface (CLI flags, config file format, prompt/agent template variables, and progress file structure).

Fixed

• Validate plan has task sections before task loop #291 @umputun

Fixed

• Preserve progress file on failed run (#288) #289 @umputun

Improved

• Add optional --effort level to task_model / review_model via model[:effort] syntax #285 @umputun

Improved

• Rename claude_model/--claude-model to task_model/--task-model for symmetry with review_model/--review-model #284 @umputun
• Pass task model to plan mode (was missing in #272)
• Clarify docs that model flags are passed to custom wrappers (may be ignored or implemented)

Fixed

• stripFlag now handles --flag=value and bare --flag forms, prevents duplicate --model in claude_args #284 @umputun

New Features

• Add GitHub Copilot CLI support #275 @AOrlov
• Add per-phase Claude model configuration #272 @dwilberger

Improved

• Skip post-codex claude review when no findings #282 @umputun
• Update all dependencies 2bc0008

Fixed

• Reduce macOS credential cleanup race and fail fast on missing creds 33390d9

Improved

• Bump github.com/go-jose/go-jose/v3 from 3.0.4 to 3.0.5 #264 @app/dependabot
• Update all dependencies 3f4d7d44
• Document agent fallback behavior in CLAUDE.md and llms.txt 1c898c15
• Clarify agent customization and disable mechanism in README b4e03548

Fixed

• Prevent indefinite hang on Windows when child processes hold pipes open #273 @stanurkov
• Add "Not logged in" to default Claude error patterns #269 @nnemirovsky
• Case-insensitive path handling for worktree plan commits on macOS #266 @umputun

Improved

• Update README.md to link plan creation in quick start #261 @ksenks
• Add jq to docker image afdfb47

Improved

• Unify gitignore handling and fix write error reporting #252 @vkazmirchuk
• Unify startup header and completion footer display 9af32cd
• Revert coveralls → codecov, switch back to coveralls 63d8a7f

Fixed

• Use .ralphex/.gitignore instead of modifying root .gitignore #260 @rsolmano

New Features

• Add idle timeout for claude sessions #250 @umputun
• Task pause+resume via SIGQUIT #249 @umputun
• Add InitLocal API and --init CLI flag for local config setup #245 @vkazmirchuk

Improved

• Bump github.com/fatih/color from 1.18.0 to 1.19.0 #243 @app/dependabot

Fixed

• Prevent false positive pattern matching on claude analysis text #251 @umputun

New Features

• Add commit_trailer config option for attribution trailers on commits #242 @umputun
• Per-file fallback for agent loading #239 @umputun

Fixed

• Use Optional[] syntax in ralphex-dk.sh for Python 3.9 compatibility #241 @alkk
• Fix Windows command-line length limits problem for codex execution #233 @stanurkov

Fixed

• Fix default colors for light terminal readability #237 @umputun

Improved

• Add RALPHEX_DOCKER_NETWORK env var and --network CLI flag #230 @umputun

Fixed

• Prevent non-automatable checkboxes in plan Task sections #228 @umputun

Fixed

• Kill orphaned child processes on normal exit #227 @umputun

Fixed

• Fix wrapText continuation lines using reduced width instead of full terminal width

New Features

• Add session_timeout config option for hanging session safety net #225 @umputun

Fixed

• Prevent infinite loop when checkboxes are outside Task sections #222 @romrigger
• Fix progress output text wrapping and code smells #226 @umputun

New Features

• Support host Docker socket mounting in container for Docker-dependent workflows #223 @umputun

Improved

• Code smells cleanup: structure and convention improvements #217 @umputun
• Bump golang.org/x/term from 0.40.0 to 0.41.0 #219 @app/dependabot
• Bump github.com/charmbracelet/glamour from 0.10.0 to 1.0.0 #218 @app/dependabot

Fixed

• Pass Claude prompt via stdin to avoid Windows cmd.exe length limit #220 @stanurkov

New Features

• Dry run flag for docker wrapper script #213 @bronislav
• Introduce gemini-as-claude wrapper #212 @korjavin
• Externalize codex review prompt as configurable template #216 @umputun
• Add codex_review.txt template file and config wiring
• Add {{PREVIOUS_REVIEW_CONTEXT}} variable and refactor buildCodexPrompt to use template

Improved

• Reorganize scripts/ into functional subdirectories #210 @umputun
• Show progress log path at completion #204 @DmitriyAlergant
• Deduplicate local config detection when it matches global dir
• Document worktree mode limitations and review workaround

Fixed

• Use --output instead of --format for aws export-credentials #203 @bronislav
• Pass progress file to external review prompts for iteration history

Fixed

• Use sentinel error to prevent infinite retry on I/O failures in plan draft review
• Output invalid selection warnings to stdout instead of log for consistent interactive flow
• Fix test name mismatch ("retry then accepts" → "retry then rejects")

Improved

• Harden workflows, upgrade actions, fix caching (#184) @paskal
• Revert golangci-lint pinning to latest

Fixed

• Retry invalid selections in plan draft review (#202) @umputun

New Features

• Add opencode-as-claude wrapper and opencode-review scripts (#199) @mschedrin

Improved

• Add python tests for docker wrapper script

Fixed

• Prevent false positive pattern matching on clean codex/custom exit (#200) @umputun
• Prevent custom review output duplication in progress log (#198) @umputun
• Ensure test creates temp claude config dir for Linux CI

New Features

• Add AWS Bedrock support for Docker wrapper (#169) @bronislav

Improved

• Refactor docker wrapper to use argparse for CLI parsing (#183) @bronislav
• Update default codex model to gpt-5.4
• Bump golang.org/x/sys from 0.41.0 to 0.42.0 (#190) @app/dependabot
• Bump docker/build-push-action from 6 to 7 (#189) @app/dependabot
• Bump docker/setup-buildx-action from 3 to 4 (#188) @app/dependabot
• Bump docker/login-action from 3 to 4 (#187) @app/dependabot
• Add FAQ entry for custom gate steps in task prompt
• Fix broken relative links in README for MkDocs site

Fixed

• Commit pending changes after external review loop early exit (#186) @umputun
• Isolate integration tests from global config
• Exclude gosec G118 from lint config
• Use compact date format in goreleaser version string

New Features

• Add RALPHEX_EXTRA_ENV support for passing environment variables to Docker (#179) @bronislav
• Implement manual break command (SIGQUIT/Ctrl+) for external review loop
• Add review patience: terminate external review after N consecutive unchanged rounds (stalemate detection)

Improved

• Fix slow tests and use t.Context() instead of context.Background()
• Update playwright-go to v0.5700.1
• Update go dependencies and github actions
• Use env: mapping for head_branch in docker workflow (#174) @paskal

Fixed

• Isolate TestTasksOnlyModeBranchCreation from global config (#177) @bronislav
• Show dirty file list in uncommitted changes error (#175) @umputun

New Features

• Add wait-on-limit mode: automatic retry on rate limits with configurable duration (#168) @umputun

Improved

• Add FAQ entry about using ralphex with Claude Pro plan
• Document wait-on-limit feature

Fixed

• Fix worktree mode rejecting non-main/master default branches (#165) @umputun

New Features

• Add configurable VCS command with Mercurial support (#162) @paskal
• Add configurable iteration limit for external review phase (#160) @umputun
• Add max_iterations as config file option

Fixed

• Fix broken "Available images" anchor link in README

New Features

• Add git worktree isolation for parallel plan execution (#158) @umputun

Improved

• Bump goreleaser/goreleaser-action from 6 to 7 (#148) @app/dependabot
• Add codecov config to ignore mock directories
• Replace coveralls with codecov for coverage reporting
• Add worktree isolation documentation
• Add coverage for worktree and ensureGitIgnored paths

Fixed

• Make web dashboard reachable from host in Docker (#152) @nnemirovsky
• Handle nested claude session error instead of silent loop
• Auto-detect host timezone in Docker wrapper

New Features

• Add extra volume mount support to Docker wrapper (#142) @alkk

Fixed

• Fix dashboard task numbering on mid-run plan edits (#147) @umputun
• Adapt review prompts for codex multi-agent flow (#143) @krajcik

Fixed

• Stop embedding diff in parallel agent prompts to reduce launch latency (#141)
• Extract separator constant, assert test cleanup errors

Improved

• Add codex wrapper script for alternative provider support (#133) @umputun
• Add custom providers documentation

Fixed

• Detect completed progress files and start fresh on reuse (#134) @umputun
• Ensure fallback result event fires when codex exits non-zero

Fixed

• Append progress files on restart instead of truncating (#130) @umputun
• Use rune-based truncation for external review summary to avoid corrupting multi-byte UTF-8 characters