gentle-shell
gentle-shell turns a session of the Pi coding agent into a workspace with agent orchestration, live changes and runtime status, usage meters for supported provider accounts and built-in diff views. Its everyday workflow, Organic Driven Development, keeps questions, reviews and proposals read-only until you ask for a change, explores before editing, and gives larger authorized work one recoverable feature document so progress survives an interruption.
Focused explorer, writer and verifier sub-agents are only used for a stated reason, such as a high-risk change getting an independent verifier, and the README publishes small single-run benchmarks of how this routing cut time and cost. Other pieces include Engram memory, background jobs and monitors, Normal, Auto or YOLO permission modes, cross-session coordination and Gentle Design for HTML design directions. v4.1 added clean-machine installers for macOS, Windows and Linux. MIT-licensed; it requires Pi and is opinionated about workflow.
Features
Why choose it
Trade-offs
Maintenance check
- Last commit
- 2026-11-12
- Commits, last 90 days
- 100+
- Releases, last 90 days
- 30
- Latest release
- v4.7.0 (2026-11-07)
- Open issues
- 501
- Recent issues with at least one comment
- 3/14
Oldest week on the left; the latest four weeks are orange. Source: GitHub commit activity.
Status rule: archived on GitHub = Archived; last commit within 90 days = Active; 91 to 365 days = Slowing; older = Stale. All figures come from the GitHub API on the date shown.
Most discussed open issues
- #1064 feat(profiles): support session-bound active profiles without global routing mutation63 comments · 2026-09-15
- #1154 bug(rdd): gentle_review_capture rejects fresh status collectBinding with capture-binding-rejected24 comments · 2026-09-17
- #992 bug(review): committed-range START unreachable (3 contradictory prerequisite errors → native schema-incompatible) and inspect bases the rang23 comments · 2026-09-13
- #741 bug(review): correction-plan captures always rejected — binding target (frozen authority) compared against live STATUS target21 comments · 2026-09-08
- #2740 feat(design): canvas review loop — redesign, sizes and export, token inspector, history, mix and partial handoff, Spanish20 comments · 2026-11-02
Issue titles are quoted from GitHub. Open the link to check whether a problem still applies to the version you use.
Use cases
Alternatives
Comments
No comments yet. Be the first!