VerifiedPlugin
gentleman-programming-…
Persistent memory system for AI coding agents. Agent-agnostic Go binary with SQLite + FTS5, MCP server, HTTP API, CLI, and TUI.
20 skills7.1k
@gentleman-programmingAgent Orchestration
Plugin
gentle-shell
Gentle Shell is a Pi-native coding-agent harness for controlled development with Organic Driven Development, optional SDD/OpenSpec, subagents, TDD evidence, review guardrails, skills, and memory integrations.
Plugin Signal84/100Strong
maintained100
capable65
documented100
adopted66
Install
$ npx -y skills add gentleman-programming/gentle-shell --agent claude-code
Stats
1,221
Stars
184
Forks
Active
Maintenance
TypeScript
Language
MIT
License
14m ago
Last commit
5mo ago
Created
14h ago
Added
Repo: gentleman-programming/gentle-shell
What's inside
Skill(12 skills)
/branch-prCreate Gentle AI pull requests with issue-first checks. Trigger: creating, opening, or preparing PRs for review./chained-prTrigger: PRs over 400 lines, stacked PRs, review slices. Split oversized changes into chained PRs that protect review focus./cognitive-doc-designDesign docs that reduce cognitive load. Trigger: writing guides, READMEs, RFCs, onboarding, architecture, or review-facing docs.
Agent(10 agents)
gentle-ai-exploreRead-only exploration and mapping for generic ODD work.gentle-ai-verifyRead-only technical verification for generic ODD work.gentle-ai-workerScoped package-owned implementation writer for bounded ODD work. Edits code, runs focused tests, and returns review-ready evidence without committing.
README
https://github.com/user-attachments/assets/fa5c0cfe-06e7-4c0d-bd6e-8ac7cb934339
https://github.com/user-attachments/assets/6d2bc422-a4dd-4ecf-a04b-fcd3bea7fea9
Built for Pi. Shaped by Gentle-AI.
Features
gentle-shell — Your coding agent, in the workspace you lead
A bare terminal answers "what is the agent doing?" only with scrollback. gentle-shell turns your Pi session into a workspace: agent orchestration, live changes and runtime status, usage monitoring for supported provider accounts, and built-in diff views — so you lead the work instead of chasing it.
el Gentleman — Think before you build
Say what you need once, then keep moving. el Gentleman helps turn intent into clear scope, a sensible next step, and evidence people can review — without making every task feel like a process meeting.
Focused agents — Context with a return path
Bring in help without losing the thread. Focused package-owned Pi agents can map a codebase, implement a bounded change, or verify it, while one parent stays accountable for the scope, the decisions, and the final summary.
ODD — The everyday workflow
Organic Driven Development (ODD) is the everyday path: the agent explores before changing anything, clarifies only real decisions, and keeps small understood work small. Substantial, authorized work gets one recoverable feature document — mirrored in memory when available — so progress, evidence, and the next step survive an interruption; checks follow the configured TDD mode.
Native review — Review the exact change
Review the exact change, not a moving target. Native review keeps one candidate in view, returns risk-scoped evidence, and can surface a bounded correction path. You still decide what happens next in your repository.
Gentle Changes — Every edit, attributed and reviewable
You should not have to run git status to find out what your agent did. Gentle Changes captures the successful write and edit tool calls from the current session and its owned subagents — no repository scans, no background polling — and shows them in a two-pane viewer with per-file line counts and an honest diff unavailable when an external edit breaks continuity. Coverage stops at those tools, so shell commands and failed runs leave no row, and a missing entry never proves a clean tree. alt+g opens it; o drops the real file into your editor.
Gentle Agents — Parallel work with a live view
Delegating work should not mean losing it. Every subagent runs as its own process with a live card above the editor — model, tokens, cost, elapsed — and alt+a opens the full view with retained threads, stop controls, and history restored on resume. A child can ask you a question as an ordinary dialog, and background results come back as cards that start a new turn — nothing polls.
Profiles and model routing — One deliberate decision per knob
Model, effort, and who does what should be choices, not accidents. Named profiles route the orchestrator atomically and independently from packaged and review roles; a repository can pin its profile so its subagents stop following the globally active one, and the panel always shows the routing the runtime actually uses.
🚀 YOLO 🔥 — Session permission, destructive guards intact
🚀 Full speed, destructive actions still ask. YOLO removes repeated permission questions for ordinary already-scoped work, which suits long autonomous runs. Destructive operations still require fresh confirmation.
/gentle:yolo enable supplies standing permission for ordinary already-scoped implementation, checks, commits, non-force pushes and PR creation. Default OFF, interactive primary TUI only, bound to the live session and Git clone; /gentle:yolo disable revokes it and /gentle:yolo status checks it. With no argument, /gentle:yolo opens a menu (enable, disable, status) showing the current state; cancelling changes nothing, and without an interactive menu it reports status. Reload and session replacement reset it. Active status plus a separate widget show 🚀 YOLO ON 🔥 — destructive confirmations remain. Explicit restrictions, configured confirmations/blocks, consequential unresolved choices, destination/credential ambiguity and native consent/recovery decisions remain mandatory. Children get no independent delivery grant. This is not a sandbox.
Or open /gentle:customize → Editor and select YOLO: OFF · session only, immediately below Vim. Enter or Space toggles the same live-session permission as /gentle:yolo; browsing and previews never activate it. Unlike Vim, YOLO is not saved in preferences or visual profiles.
Command palette — Every command, one keystroke away
Extension commands are only useful if you can find them. alt+k opens a curated, grouped palette — Configuration, Session, Diagnostics, and Skills — searchable by label, command name, or description, showing entries only when they are actually registered.
File tree
More plugins by @gentleman-programming.
View @gentleman-programming’s profile@gentleman-programmingFAQ
gentle-shell is a Claude Code plugin with 12 hand-picked skills for agent orchestration work, indexed on Flowy. Install it with the command on its page. It includes branch-pr, chained-pr, cognitive-doc-design. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
- What is gentle-shell?
- Gentle Shell is a Pi-native coding-agent harness for controlled development with Organic Driven Development, optional SDD/OpenSpec, subagents, TDD evidence, review guardrails, skills, and memory integrations.
- How do I install gentle-shell?
- Run these in Claude Code: npx -y skills add gentleman-programming/gentle-shell --agent claude-code. Then prompt normally.
- Does gentle-shell auto-invoke its skills?
- Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
- Is gentle-shell free?
- Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.
Is this plugin yours?
Claim it with GitHubSubmit a pluginPromote it