Repository navigation
Gentle AI v5.0.0 is a major release. It moves the Go module to /v5, removes legacy review authority, and improves recovery when Gentle Shell installs and updates fail. The managed provider bundle retains version 1.6.0, with updated routing and orchestration files. The review CLI changes below still apply.
Provenance
- Previous stable:
v4.6.0→08317b9589598f99ebcc00498c39a60f352f05e4 - Release target:
v5.0.0→4716b3cbca158c35c3b316dbd517f54e5f240f97 - Release workflow: run 45014677938
- Verification: preflight, release, and verify jobs all succeeded.
- Provider contract:
1.6.0
What's new
A single review-due decision
The Stop hook reads the same review-due decision as the review entry path. An explicit escalation now reaches that entry decision instead of being dropped.
Included work: #6204 and #6214.
One abandonment route for stuck review lineages
gentle-ai review abandon covers stuck lineages through one route. It still requires the exact current revision (--expected-revision) and the maintainer authorization binding (--maintainer-authorization).
Included work: #6207.
Breaking changes
- Go module: the module and command paths move from
/v4to/v5. Update imports, build scripts, and pinnedgo installcommands when adopting v5. #6223 (issue #6222). - Review authority: legacy v1 review authority is removed. Integrations that still rely on it must use the supported review protocol. The
capabilities/v2.6payload changed without an identifier bump, so consumers should refresh their capability discovery rather than treating that identifier as proof of the old feature set. #6211.
Run gentle-ai sync after updating the binary so local integrations discover the current review behavior.
Upgrade now
brew upgrade gentle-ai
gentle-ai syncWindows and other source installs:
go install github.com/gentleman-programming/gentle-ai/v5/cmd/gentle-ai@v5.0.0
gentle-ai syncRun gentle-ai sync after upgrading so managed agent, reviewer, and runtime assets match the installed binary.
What was fixed
Safer Gentle Shell installs and updates
A failed Windows replacement restores the previous backup, and transient file locks no longer cause immediate failure. Downloads tolerate slow or flaky connections, and operations targeting the same installation are serialized. The TUI can exit the failure screen, cancel before publication, and recover from an update-check failure.
Included work: #6185, #6186, #6189, #6190, #6191, #6192, and #6205.
Version-correct update guidance
A beta install can recover from tagged releases without downgrading. On Windows, the stable Go install instruction uses the exact published tag and the module major that matches it. If stable metadata is unavailable or invalid, Gentle AI does not offer an unverified install command.
Included work: #6219 and #6223 (issue #6222).
Windows Hermes discovery and review STATUS
Windows Hermes discovery honors HERMES_HOME and %LOCALAPPDATA%. Base-ref review STATUS now answers an untracked-file declaration through its typed collect route.
Included work: #6206 and #6195.
Numbers
61 non-merge commits, 21 merged pull requests, and 3 unique GitHub PR authors since v4.6.0.
Install
brew install Gentleman-Programming/tap/gentle-aior
go install github.com/gentleman-programming/gentle-ai/v5/cmd/gentle-ai@v5.0.0Windows remains supported through the Go installation path. Official Windows binary archives and Scoop publication remain unavailable; Windows upgrades fail closed to Go-based guidance rather than downloading unsigned binaries.
Signed platform archives below: linux_amd64, linux_arm64, darwin_amd64, darwin_arm64, with checksums.txt and its minisign signature.
Full changelog: v4.6.0...v5.0.0