Repository navigation
Gentle Shell v4.9.0 is a minor release that adds desktop and browser views for working with sessions, expands the Desktop RPC interface, and updates the bundled Gentle AI runtime to v4.6.0. The npm package remains gentle-pi.
Provenance
- Previous stable:
v4.8.0→3dc9029755912358d0a172b4972e5842c239570c - Release target:
v4.9.0→ce64a9a708e50c0ca899c8023140e63f29f293e1 - Release validation: run 44369145609 passed package verification, published
gentle-pi@4.9.0to npm with provenance, and built all three installers. The distribution installed and ran with a frozen lockfile on Linux, macOS, and Windows. - Pinned Gentle AI: v4.6.0 (
08317b958); the provider contract advances from1.5.0to1.6.0.
What's new
Desktop and Tower
Gentle Shell Desktop gives Herdr-hosted sessions a native window for chat, controls, and the terminal. Windows users still install Herdr separately. Gentle Tower gives you a local browser view of sessions, tasks, and artifacts; increases in permissions still require confirmation in the terminal. Interactive Herdr sessions can publish bounded activity records so you can see what jobs and agents are doing.
Included work: #3277, #3270, #3348 (issue #3347).
Desktop clients can see and switch sessions
Desktop RPC clients can list and switch sessions, request selected snapshot sections, and receive snapshot updates. Requests that overlap a switch get a retryable response. Clients can also read cached update status or explicitly refresh it; a failed check reports unknown, not up to date.
Included work: #3330 (issue #3320), #3328 (issue #3319), #3340 (issue #3337).
Desktop clients can inspect work and controls
Clients can read bounded subagent threads and job-output tails, inspect changed files and bounded diffs, and get usage statistics. Threads and output may contain unredacted task or process text. Clients can also read or request a change to receipt-driven development mode, with confirmation. Config and permission events now also report best-effort external changes; use their source to distinguish them from writes made by the client.
Included work: #3334 (issue #3323), #3329 (issue #3309), #3333 (issue #3322), #3327 (issue #3325), #3326 (issue #3324), #3335 (issue #3321).
Profiles, design, and orchestration
Eligible new sessions use their resolved profile's orchestrator without changing saved defaults. Unusable models leave the current model in place and show a notice. The design canvas adds a Gentleman theme while keeping Neutral as the default. Updated orchestration guidance keeps independent authorized work moving, uses decision tools for choices they can represent, and lets the parent decide edit-surface additions that stay within scope. Responses no longer require a closing Key Learnings section.
Included work: #3208 (issue #1064, split #2716), #3289 (issue #2740), #3286 (issue #3285).
Gentle AI v4.6.0 pin
The package and double-click installers use the same verified Gentle AI v4.6.0 release. See Pinned runtime for the platform and contract details.
Included work: #3371 (issue #3370).
What was fixed
Decisions and recovery
Ordinary choice dialogs now accept typed answers by default; closed consent and exact-token choices keep their fixed options. Workers that exhaust corrections now return a diagnosis for the orchestrator to act on, and refused delegation explains the next step. Managed guidance distinguishes ordinary system-temp reads and writes from deletion, without changing runtime guards.
Included work: #3292 (issue #3291), #3339 (issue #3338), #3300 (issue #3299).
Profiles and skill discovery
Profiles can save Fast mode for GPT-6.2 Sol and Astra on supported routes. Skill discovery skips hidden entries at skill roots and prefers the named skill over a backup copy.
Included work: #3350 (issue #3349), #3298 (issue #3297).
Pinned runtime
Gentle Shell pins Gentle AI v4.6.0 (github.com/gentleman-programming/gentle-ai/v4). Darwin and Linux use the signed release archives and pinned binary SHA-256 values. Windows builds from the SumDB-verified Go module. The upstream provider contract is now 1.6.0, and the published bundle matches all ten files in Shell's existing mirror byte-for-byte. The NATIVE_CLI_CONTRACTS row for 4.6.0 preserves the CLI's capabilities/v2.6 identity.
Breaking changes
No user-facing command or package interface break is declared. Desktop RPC clients must handle config and permission events from outside their own writes. Callers that require an ordinary choice dialog to accept only the listed options should explicitly disable custom responses.
Upgrade
pi install npm:gentle-pi@4.9.0Restart Pi, then run gentle-ai sync so the managed orchestrator assets match the pinned runtime.
Numbers
37 non-merge commits, 21 merged pull requests, and 5 unique GitHub PR authors since v4.8.0.
Verification
- Package verification passed: 302 files and 69 byte-pinned package contract artifacts.
npm pack --dry-runpassed, and the packedgentle-pirunner exercised the real published Gentle AIv4.6.0assets. - Independent verification matched all four archive and executable digest pairs, the Windows SumDB checksum, the ten provider mirror files, and the live CLI capability contract. The focused contract suite passed 33 tests.
- Local macOS arm64 full suite: 11,280 passed, 96 skipped, and the same six environment-specific failures as on the unmodified base. Provider and runtime harness stages passed. The canonical PR CI for pin head
2310efd00passed all seven jobs, including the full Linux verification and the macOS session-transport job. - Native review: both high-risk Desktop slices (#3277) were approved after one bounded correction each. Tower (#3270) exceeded the whole-branch review budget, so four sensitive-code slices were reviewed and approved separately. Eight Desktop RPC PRs (#3326–#3330 and #3333–#3335) record approval and non-blocking follow-ups. The PR notes do not record lineage IDs or a complete count of findings.
Install
pi install npm:gentle-pi@4.9.0Package: https://www.npmjs.com/package/gentle-pi
Full changelog: v4.8.0...v4.9.0