Gentle AI v3.6.1 is a patch release that removes a conflicting third-party Pi tool, improves OpenCode skill-registry failure diagnostics, and clarifies ODD routing and Gentle Shell setup. The provider contract stays byte-frozen at 1.2.0.
Provenance
- Previous stable:
v3.6.0→314bbbbd6d82950c0c54cd9050ec6ea83bf785d8 - Release target:
v3.6.1→623624edb0a82612bc8394b604b833059343b823 - Release workflow: run 35794216609
- Verification: preflight, release, and verify jobs all succeeded.
- Provider contract:
1.2.0
What's new
No new features are declared for v3.6.1.
Breaking changes
No breaking changes are declared for v3.6.1. The Go module path stays at github.com/gentleman-programming/gentle-ai/v3, and the provider contract remains byte-frozen at 1.2.0. Pi users should run gentle-ai sync after upgrading: the managed package list changed, and sync prunes the retired third-party ask_user_question package from existing installations.
Upgrade now
brew upgrade gentle-ai
gentle-ai syncWindows and other source installs:
go install github.com/gentleman-programming/gentle-ai/v3/cmd/gentle-ai@v3.6.1
gentle-ai syncRun gentle-ai sync after upgrading so managed agent, reviewer, and runtime assets match the installed binary.
What was fixed
Pi starts without a duplicate question tool
Gentle Pi now supplies its own ask_user_question tool; retaining the older third-party package could prevent Pi from loading because tool names collided. Gentle AI no longer manages that package, and install or sync prunes it from existing homes. Included work: #4893 (issue #4820).
OpenCode skill-registry failures report what the runtime knows
A spawn failure could be reported as a missing PATH entry even when the executable was visible to OpenCode. The diagnostic now describes a failure to spawn or resolve without guessing its cause, remains single-line, and lets startup continue with an actionable refresh path. Included work: #4896 (issue #2971).
Gentle Shell setup is easier to distinguish from Pi's default home
The Pi documentation now explains the isolated Gentle Shell agent home, PI_CODING_AGENT_DIR, and the managed plugin lifecycle, with a pointer from the agent guide. Included work: #4898 (issue #4897).
ODD delegation and verification match the work at hand
Routing guidance still delegates work touching two or more non-trivial files, without counting a later mechanical edit as a second non-trivial file. It also calls for validating consequential premises, reusing relevant sibling findings, and running focused checks before applicable full checks without a hard spend gate. Included work: #4900 (issue #4894).
Numbers
12 non-merge commits, 4 merged pull requests, and 2 unique GitHub PR authors since v3.6.0.
Install
brew install Gentleman-Programming/tap/gentle-aior
go install github.com/gentleman-programming/gentle-ai/v3/cmd/gentle-ai@v3.6.1Windows 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: v3.6.0...v3.6.1