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.

1,786 2,267 2,747 Nov 6, 2026 Nov 16, 2026
GitHub stars for gentle-shell: 1,852 on Nov 6, 2026, 2,681 on Nov 16, 2026. Source: GitHub.

Ranking history

First ranked in week 46, 2026.

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.

Also compared with gentle-shell on these pages:

Last updated Nov 16, 2026. Tracked since Nov 6, 2026. Parts of this summary required judgment because the source material was brief. Spotted an error? Tell us.