gentle-shell
gentle-shell is a terminal coding agent workspace that keeps tasks, code changes, and reviews in one place for developers using the Pi coding agent.
What it is good for
- Keeping AI coding changes under control while the agent works
- Reviewing the exact code change an AI agent made
- Splitting a coding job across several AI helpers without losing track
- Keeping progress and notes when a coding session gets interrupted
At a glance
- Who it is for
- Setup difficulty
- Technical ยท Guided command-line setup
Level 4 of 5. You copy and paste commands into a terminal by following the instructions. Comfortable territory for vibe coders.
- Cost
- Free and open source
- Type
- Agent app
- Tasks
- Works with
- Pi, Git, Codex CLI
Before you try it
- Built for Pi, so it is meant to run with the Pi coding agent.
- Review features need a filesystem that supports private file permissions; some WSL mounts can fail.
- Benchmark results come from single runs, and large tasks still ran slower than Codex CLI.
Momentum
- Rank this week
- #70
- Best rank
- #70 week 46, 2026
- Stars gained last week
- +595
- GitHub stars
- 2,681
GitHub numbers as of Nov 16, 2026. Updated weekly.
Ranking history
Official links
Setup steps are on the official pages. We do not repeat them here, since they change.
Questions
- Is gentle-shell free?
- Yes. It is free and open source (MIT license).
- Do I need to know how to code to use gentle-shell?
- You do not need to write code, but setup means copying and pasting commands into a terminal by following its instructions.
- What does gentle-shell work with?
- According to its own documentation, it works with Pi, Git, and Codex CLI.
- What should I know before trying gentle-shell?
- Built for Pi, so it is meant to run with the Pi coding agent. Review features need a filesystem that supports private file permissions; some WSL mounts can fail. Benchmark results come from single runs, and large tasks still ran slower than Codex CLI.
- What is gentle-shell good for?
- Keeping AI coding changes under control while the agent works, reviewing the exact code change an AI agent made, splitting a coding job across several AI helpers without losing track, and keeping progress and notes when a coding session gets interrupted.
Similar agents to gentle-shell
- Pi Pocket
Focuses on running Pi sessions from a phone-friendly web app rather than a terminal workspace with review tools.
- Kander
Uses a terminal kanban board to run agents on separate branches, rather than one parent agent delegating to helpers.
- Magic Context
Only adds memory across long sessions, while this also covers workflow, review, and delegation.
- Archon
Runs agents through fixed YAML workflows instead of sizing and routing work by risk.
- codeg
Brings many different coding agents into one workspace instead of being built around Pi.
- Claude Code
Claude Code is an agent app that writes, explains, and manages code in your terminal using plain-language commands for developers and vibe coders.