Gentle-AI configures the AI coding agents you already use: Claude Code, Cursor, OpenCode, Codex, Pi, and more. Choose persistent memory, Spec-Driven Development, curated skills, MCP servers, personas, and optional bounded review. Open source, no agent lock-in.
# Add to your Claude Code skills
git clone https://github.com/Gentleman-Programming/gentle-aiLast scanned: 9/6/2026
{
"issues": [
{
"file": "README.md",
"line": 265,
"type": "remote-install",
"message": "Install command (remote install script piped to a shell — review the source before running): \"curl -fsSL https://raw.githubusercontent.com/Gentleman-Programming/gentle-ai/mai\"",
"severity": "low"
}
],
"status": "PASSED",
"scannedAt": "2026-09-06T08:23:07.729Z",
"npmAuditRan": true,
"pipAuditRan": true,
"promptInjectionRan": true
}gentle-ai is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by Gentleman-Programming. Gentle-AI configures the AI coding agents you already use: Claude Code, Cursor, OpenCode, Codex, Pi, and more. Choose persistent memory, Spec-Driven Development, curated skills, MCP servers, personas, and optional bounded review. Open source, no agent lock-in. It has 6,302 GitHub stars.
Yes. gentle-ai passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/Gentleman-Programming/gentle-ai" and add it to your Claude Code skills directory (see the Installation section above).
gentle-ai is primarily written in Go. It is open-source under Gentleman-Programming on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh gentle-ai against similar tools.
No comments yet. Be the first to share your thoughts!
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
First time here? Follow Install for prerequisites and the platform-specific binary command, then:
# Pick your agents, components and persona
gentle-ai
# Verify the installation
gentle-ai doctor
You installed Claude Code, OpenCode, Cursor or Codex. It writes code — but it forgets everything between sessions, has no opinion about how your project works, and gives you no way to check its work beyond reading every line yourself.
Gentle-AI is an ecosystem configurator. It takes the agent runtime already on your machine and equips it with persistent memory, a planning workflow, a curated skill library, MCP tool servers, model routing, a teaching-oriented persona, and an optional evidence-based review step.
Before
"I installed an AI agent, but it's just a chatbot that writes code."
After
The agent remembers your decisions, follows your project's conventions, picks a working style that matches the size of the task, and can produce reviewable evidence for what it changed.
[!IMPORTANT] Gentle-AI never installs an AI agent for you. It configures runtimes that are already present. If you select an agent it cannot detect, it refuses and prints the exact command you'd run yourself — it will not silently install software on your machine.
Gentle-AI installs a set of components. You pick them individually, or take a preset.
Engram™ · Recommended
Persistent memory across sessions — decisions, bug fixes, and context survive restarts.
Skills · Recommended
A curated library of coding skills the agent loads when the task matches.
Persona · Optional
A teaching-oriented voice (Gentleman or neutral), or your own custom persona.
SDD · Optional
Spec-Driven Development — a planning workflow for substantial features.
Context7 · Optional
An MCP server that fetches live framework and library documentation.
Permissions · Optional
Security-first guardrails, including a deny list for ~/.ssh, .env, and credential files.
GGA · Optional
Gentleman Guardian Angel — an AI provider switcher.
Theme · Optional
Selectable Gentleman and Gentleman-Cute themes for Claude Code and OpenCode.
| Preset | Includes |
|---|---|
Dev Stack + Polish full-gentleman |
Every component and every skill |
Dev Stack ecosystem-only |
Engram, SDD, Skills, Context7, GGA + all skills |
Memory Only minimal |
Engram and SDD skills |
| Custom | You choose; existing persona and settings stay untouched |
Full breakdown: Components, Skills & Presets.
Gentle-AI configures each agent using that agent's own native features, so capabilities differ. Delegation model tells you whether the agent can hand work to focused sub-agents or runs everything in one conversation.
| Agent | Mechanism | Key feature |
|---|---|---|
| Claude Code | Task tool | Sub-agents, output styles |
| OpenCode | Multi-mode overlay | Per-phase model routing |
| Kilo Code | Multi-mode overlay | OpenCode-compatible config in ~/.config/kilo |
| Gemini CLI | Experimental | Custom agents in ~/.gemini/agents/ |
| Cursor | Native subagents | 10 SDD agents in ~/.cursor/agents/ |
| VS Code Copilot | runSubagent | Parallel execution |
| Codex | Native multi-agent | CLI-native TOML config; enabled by default with solo-agent fallback |
| Antigravity | Dynamic subagents | Mission Control uses define_subagent + invoke_subagent for SDD phases |
| Kimi Code | Native custom agents | Modular prompt templates in ~/.kimi |
| Kiro IDE | Native subagents | Native ~/.kiro/agents/ + steering orchestration |
| Qwen Code | Native sub-agents | Slash commands, ~/.qwen/commands/, auto_edit mode |
| Pi | Package-managed subagents | First-class gentle-pi harness with Pi-native persona/models, SDD, and Engram memory |
| Hermes | delegate_task |
Ephemeral fresh-context workers; YAML MCP config and SOUL.md persona |
| Agent | Key feature |
|---|---|
| Windsurf | Plan Mode, Code Mode, native workflows |
| OpenClaw | Workspace-first AGENTS.md / SOUL.md with global MCP config |
| Trae | Desktop app by ByteDance; ~/.trae/skills/ + OS-specific rules |
Hermes must be installed manually first. Gentle-AI detects and configures the existing runtime; it does not install Hermes.
[!NOTE] Pi is package-managed, not just configured. Selecting Pi installs the first-class
gentle-piharness, which owns Pi-native persona and model controls, SDD assets, chains, and memory wiring.
[!NOTE] This project supersedes Agent Teams Lite (now archived). Everything ATL provided is included here with better installation, automatic updates, and persistent memory