v2.6.0 — A Workspace You Can Watch and Steer

gentle-pi v2.6.0 makes Pi's runtime experience more observable, navigable, and controlled — especially in Gentle Shell and Gentle Agents — while updating the package-local Gentle AI integration and letting review and SDD follow native authority more precisely.

Provenance

• Previous stable: v2.5.0 → d4792faf
• Release target: v2.6.0 → 963e17f78490502a1638bcddc73e4207b8224ee6
• CI workflow: run 34756674378
• Verification: package verification (verify) and Windows review (review-repository-windows) jobs both succeeded; pnpm test, the provider contract mirror check, and the packed runtime harness passed on the release candidate; package verification passed with 169 required files and 69 exact byte-identical contract artifacts for the Gentle AI v2.8.0 runtime; npm pack --dry-run passed with 470 packaged files.
• Pinned Gentle AI: v2.8.0, provider contract 1.2.0

What's new

Gentle Shell now keeps the whole workspace in view

Session worktrees persist across reloads and /gentle:changes groups their diffs instead of flattening them into one list. The changes view now shows Git status and line counts, supports fullscreen pointer navigation, and opens inside a responsive sidebar that follows live session state. Fullscreen rendering reuses and caches unchanged frames, while contained styling and execution metadata keep the shell readable without hiding what an agent is doing.

Included work: #725, #739, #771, #779, #711, #840, #876, and #930.

Gentle Agents grows from a task list into an orchestration console

Agents are grouped by orchestrator session and presented with hierarchical, resize-safe List and Details navigation, semantic thread blocks, native Close and fullscreen controls, and retained completion history. Live orchestrators and their direct children are visible together; bounded child-to-parent notifications, correlated queries, and foreground handoff let a child ask for input without leaking raw protocol messages into the conversation.

Included work: #692, #698, #702, #712, #756, #776, #786, #788, #790, #794, and #841.

Agent state is more honest after the happy path ends

Completed groups remain available, aborted runs record why they ended, lost process exits settle into durable terminal records, and background completion belongs to the current turn rather than a stale host queue. Runtime observations identify packaged agents by model and effort, expose bounded usage, avoid duplicate elapsed-time displays, and keep Windows child consoles hidden.

Included work: #762, #853, #854, #885, #907, #912, #913, and #929.

Named profiles make model routing a live runtime choice

/gentle:profiles stores named agent-model profiles, applies them atomically, and opens a fullscreen selector where the orchestrator and each packaged agent can have independent provider, model, and effort settings. Routing consumers now share one authority, provider-owned review roles are configurable, and the details pane uses the same line-by-line navigation as Gentle Agents.

Included work: #845, #894, #901, #904, #917, #921, and #932.

Review and SDD follow native authority more precisely

Review inspection names and resolves intended-untracked selection, consent is shorter and easier to scan, deterministic relay failures can close impossible lens slots, committed-range START follows the provider's offered route, and reconciliation preserves native continuations and diagnostics. SDD research, planning, execution, selected-change routing, and startup status now consume native authority while requiring parent-confirmed session preflight.

Included work: #717, #796, #802, #822, #844, #860, #862, #864, #887, #888, #892, #933, #949, #953, #954, and #957.

Installation and package boundaries are clearer

Assets can be installed by subsystem, skipped npm lifecycle scripts now produce explicit recovery guidance, global Pi Git installs are recognized, custom ask responses are opt-in, and a TypeScript type gate protects the growing runtime surface.

Included work: #803, #823, #839, #881, and #909.

Breaking changes

No breaking changes are declared for v2.6.0. The negotiated capability surface remains gentle-ai.review-integration.capabilities/v2.5, so the new 2.8.0 capability row intentionally repeats 2.7.0.

Upgrade now

pi install npm:gentle-pi@2.6.0

Restart Pi, then run:

gentle-ai sync

The package-local runtime now pins Gentle AI v2.8.0. All four release archives and extracted binaries are SHA-256 pinned; Windows source installation is bound to the v2.8.0 Go SumDB checksum.

What was fixed

Platform stability on Windows

Windows review candidates validate ownership and executable mode correctly, while startup, polling, permission, telemetry, and subagent processes stay hidden instead of opening consoles.

Included work: #795, #805, #830, and #855.

Gentle Todo and startup resilience

Gentle Todo keeps the next pending task visible when collapsed, and the startup banner survives TUI invalidation without freezing.

Included work: #880 and #842.

Review reminders and reviewer decoding

Review reminders stay scoped to session-owned mutations and disappear for acknowledged candidates; approved reviewer results decode correctly instead of surfacing transport internals.

Included work: #773, #780, and #886.

Numbers

126 non-merge commits, 77 merged pull requests, and 10 unique GitHub PR authors since v2.5.0.

Install

pi install npm:gentle-pi@2.6.0

Package: https://www.npmjs.com/package/gentle-pi

Full changelog: v2.5.0...v2.6.0