Skip to content
Day 69: new resources are added every day. See what's new
Best Productivity ResourcesBy Shushant LakhyaniVerified creator

AI Tool

Gentle Shell

Turn Pi into a senior-architect development harness with SDD, subagents and strict TDD evidence.

Visit Gentle Shell4.3

  • Rating

    4.3 / 5

  • Pricing

    Free

  • Difficulty

    Advanced

  • Works on

    macOS, Linux, Cross-Platform

Built with love by Shushant Lakhyani. Building bestproductivityresources.com

Free: 1,100+ ways people make money onlineFree: 399+ ways to make money online

What is Gentle Shell?

Gentle Shell transforms the Pi agent into el Gentleman, a senior-architect style development harness. It enforces spec-driven development with SDD and OpenSpec, orchestrates subagents, demands strict TDD evidence, applies review guardrails and discovers skills, all from your shell.

Third-party open-source projects. We are not affiliated with their authors; repositories are provided as-is by their maintainers. Review each project's license, code and security before installing. See our Disclaimer.

Pros: what Gentle Shell does well

  • Enforces disciplined spec-driven development and TDD
  • Subagent orchestration with review guardrails
  • Opinionated senior-architect workflow out of the box

Cons: where it falls short

  • Opinionated workflow will not suit every team
  • Requires the Pi agent and shell comfort
  • Advanced concepts assume experienced developers

Who Gentle Shell is for

Senior developers who want a disciplined, spec-driven agent harness.

Who can skip it

Casual users of AI coding tools.

What people use Gentle Shell for

  • Spec-driven development, where each change starts from a written plan
  • Running focused subagents for planning, building and reviewing code
  • Keeping test evidence and reviewable work units for every change
  • A disciplined workspace on top of the Pi coding agent

How to get started

  1. 1Read the README on GitHub; the npm package is still called gentle-pi during the rename.
  2. 2Download the installer for macOS, Windows or Linux from the project's GitHub Releases page.
  3. 3Expect a security warning, as the installers are not signed yet, and check the published checksums.
  4. 4Try it on a small change first to learn the workflow before using it on a real project.

Gentle Shell pricing

gentle-shell is free and open source under the MIT licence. You still pay for whichever AI model provider you connect to Pi. See current prices on Gentle Shell's site

Checked 2026-10-10. Prices change, so double-check before you pay.

Gentle Shell FAQ: quick answers

Is gentle-shell free?
Yes. It is open source under the MIT licence. Model usage is billed by the AI provider you connect.
Does gentle-shell work with Claude Code or Codex?
No. It is built for the Pi coding agent, so you need to use Pi to get its workflow.
Who is gentle-shell for?
Experienced developers who want an opinionated, spec-first workflow with tests and reviews built in.

Gentle Shell alternatives

Not sold on Gentle Shell? These do a similar job, and each card says what it has in common.

All AI Productivity resources

First Tree

Focus: orchestration, github and routing. Shares ai agents and code review with Gentle Shell. Adds Web. Same 4.3 rating.

AI ToolFreeWeb
4.3Visit

Agent Skills Workflow Template

Focus: agent skills, agents.md and claude code. Shares code review and open source with Gentle Shell. A website, not an AI tool. Adds Web. Rated 4.7 (Gentle Shell: 4.3).

WebsiteFreeWeb, Cross-Platform
4.7Visit

Build with Claude

Focus: claude code, plugins and marketplace. Shares subagents and ai agents with Gentle Shell. A website, not an AI tool. Freemium (Gentle Shell: Free). Adds Web. Rated 4.6 (Gentle Shell: 4.3).

WebsiteFree planWeb
4.6Visit

Agentsmith

Focus: model-agnostic, claude and codex. Shares ai agents and harness with Gentle Shell. A framework, not an AI tool. Adds Windows. Rated 4.4 (Gentle Shell: 4.3).

FrameworkFreemacOS, Windows
4.4Visit

Gold Band

Focus: workflows, rust and desktop. Shares ai agents and harness with Gentle Shell. A desktop app, not an AI tool. Adds Windows. Rated 4.2 (Gentle Shell: 4.3).

Desktop AppFreemacOS, Windows
4.2Visit

Harness Mix

Focus: codex, claude code and desktop. Shares ai agents and harness with Gentle Shell. A desktop app, not an AI tool. Adds Windows. Rated 4.2 (Gentle Shell: 4.3).

Desktop AppFreemacOS, Windows
4.2Visit

Free alternatives to Gentle Shell

Want to spend nothing? These free picks cover similar ground.

hol-guard

Focus: security, prompt injection and guardrails. Shares ai agents and open source with Gentle Shell. Adds Windows. Rated 4.7 (Gentle Shell: 4.3).

AI ToolFreemacOS, Windows
4.7Visit

Dormice

Focus: agent sandboxes, e2b and self-hosted. Shares ai agents and open source with Gentle Shell. Adds Web. Rated 4.6 (Gentle Shell: 4.3).

AI ToolFreeLinux, Web
4.6Visit

Builder.io Skills

Focus: skills, claude code and builder.io. Shares ai agents and open source with Gentle Shell. Rated 4.5 (Gentle Shell: 4.3).

AI ToolFreeCross-Platform
4.5Visit

Agentlas OS

Focus: orchestration, local-first and developer tools. Shares ai agents and open source with Gentle Shell. Rated 4.4 (Gentle Shell: 4.3).

AI ToolFreeCross-Platform
4.4Visit
Are you the maker of Gentle Shell?Get a free Featured badge for your site, a share image and ready-to-paste posts. No sign-up.

New · updated daily

What people are actually doing with AI

Real use cases shared on Reddit, Hacker News, X, GitHub and blogs, summarised in plain words with a link to every original post.

Browse AI use cases

Free Notion database

1,100+ ways people are making money online

Real online businesses, creators and projects, broken down by how they make money: apps, online stores, AI tools and more. Free on Gumroad.

Get the free database

Free Notion database

399+ ways to make money online

Hundreds of online income methods in one place, so you can compare options and pick one to try. Free on Gumroad.

Get the free list

For research and ideas only. Results vary and nothing here is a promise of income. See our Disclaimer.

Weekly newsletter

Everything new, every Monday.

One short email every Monday with everything shipped that week: new free tools and websites, new guides, new free browser tools and what's new in my free Gumroad libraries, plus how the site is growing. Free, and you can unsubscribe anytime.

Join the newsletter

You sign up on Gumroad, which stores your email to send the newsletter. See our Privacy Policy.