AgentIndex icon
AgentIndex
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Submit Tool
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Home/
Code Assistant/
gentle-ai
gentle-ai logo

gentle-ai

Active·★ 9.5k·MIT·Updated 2026-11-21
★ Essential★ Trending

Gentle-AI is an ecosystem configurator. It takes the AI coding agent runtime already on your machine (Claude Code, OpenCode, Cursor, Codex and others) and equips it with persistent memory, a planning workflow, a curated skill library, MCP tool servers and model routing. The README's pitch is that an agent that normally forgets everything between sessions can instead remember decisions, follow your project's conventions and produce reviewable evidence for what it changed. It never installs an agent for you; if you select one it cannot detect, it refuses and prints the command to run yourself.

You choose components individually or through presets. They include Engram (persistent memory across sessions), Skills, an optional teaching-style Persona, Spec-Driven Development for larger features, Context7 for live library documentation, Permissions with a deny list for ~/.ssh, .env and credential files, a provider switcher and themes. Presets range from Dev Stack and Polish (everything) to Memory Only. Different agents are configured through their own native features, so capabilities differ: Claude Code gets sub-agents and output styles, while OpenCode gets per-phase model routing. Start by running `gentle-ai`, then verify with `gentle-ai doctor`. The project is MIT licensed.

This write-up is based on the project's README and public repository data. We have not hand-tested the tool. Data as of 2026-11-21.

License
MIT
Latest release
v4.6.0 · 2026-11-18
Last commit
2026-11-21
Contributors
103
Forks
904
Open issues and PRs
303
First published
2026-02-27

Source: GitHub, npm and PyPI public APIs.

#AI Agent Configuration#Workflow Automation#Developer Tools#Persistent Memory#Code Review#Multi-Agent Orchestration#Spec-Driven Development
$ Install
$ curl -fsSL https://raw.githubusercontent.com/Gentleman-Programming/gentle-ai/main/scripts/install.sh | bash
↗ Visit site★ GitHub
01

Features

01Persistent memory across sessions (Engram™).
02Spec-Driven Development (SDD) planning workflow.
03Curated library of coding skills for agents.
04Evidence-based code review with Receipt-Driven Development (RDD).
02

Why choose it

+Adds persistent memory, skills, a planning workflow and MCP servers to an agent you already use.
+Component and preset model lets you take only memory or the whole stack.
+Permissions component sets a deny list for ~/.ssh, .env and credential files.
+Does not install agents itself and refuses to configure ones it cannot detect, which keeps changes predictable.
03

Trade-offs

!Capabilities differ per agent: only some runtimes support delegation to focused sub-agents, while others run everything in one conversation.
!It adds a lot to your agent setup (memory, skills, personas, themes), so review what you select, since some pieces such as the persona and themes are stylistic.
!The README is long and the ecosystem uses its own branded names (Engram, GGA), which adds a learning curve.
05

Maintenance check

ActiveChecked: 2026-11-12
Last commit
2026-11-11
Commits, last 90 days
100+
Releases, last 90 days
30
Latest release
v4.4.0 (2026-11-07)
Open issues
409
Recent issues with at least one comment
7/30
Commits per week, last 12 weeks
Commits per week, last 12 weeks: 144, 114, 185, 117, 162, 179, 216, 67, 166, 107, 89, 19

Oldest week on the left; the latest four weeks are orange. Source: GitHub commit activity.

Status rule: archived on GitHub = Archived; last commit within 90 days = Active; 91 to 365 days = Slowing; older = Stale. All figures come from the GitHub API on the date shown.

Most discussed open issues

  • #4571 bug(review 2.8.2): correction_required capture's own status_continuation classifies the just-minted authority corrupted_or_unverifiable_auth393 comments · 2026-09-14
  • #5422 [Automated provider defect] bound STATUS after granted START times out pre_native for ~800+ changed-line candidates on 4.0.0 stable (Windows145 comments · 2026-10-09
  • #4655 bug(review): bound STATUS still times out pre_native after a granted START on a 3-path medium candidate (2.9.1 stable) — regression of #3733106 comments · 2026-09-16
  • #5129 Review integration blocks on undocumented intended-untracked capture66 comments · 2026-09-30
  • #5209 [Automated provider defect] Claude Code: a granted, never-reoffered START's first capture-result lands directly on correction_required, and 58 comments · 2026-10-02

Issue titles are quoted from GitHub. Open the link to check whether a problem still applies to the version you use.

04

Who it fits

Pick it if
  • You want to add persistent memory, skills, a planning workflow and MCP servers to an agent you already run.
  • You want to pick components one by one or use presets.
  • You want a deny list for ~/.ssh, .env and credential files.
Look elsewhere if
  • Your agent does not support sub-agents: the README says some capabilities differ by runtime.
  • You only want one piece such as memory and prefer a single focused tool.
  • You do not want stylistic extras such as personas and themes in your setup.
06

How it differs

zcf logovs zcf★ 6.1k

ZCF focuses on one-command setup of workflows, API settings and MCP for Claude Code and Codex. Gentle-AI layers memory, skills and permissions onto several agents.

Full comparison →
07

Compatibility

Go
Runtime
Verified via docs
macOS
OS
Verified via docs
Linux
OS
Verified via docs
Windows
OS
Verified via docs
Node.js
Dependency
Verified via docs
npm
Dependency
Verified via docs
08

Quick start

1
$ curl -fsSL https://raw.githubusercontent.com/Gentleman-Programming/gentle-ai/main/scripts/install.sh | bash
09

Use cases

↳Developers who already use an AI coding agent daily and want it to stop starting from zero.
↳Teams that want consistent agent behavior across different agent runtimes and machines.
↳Anyone who wants to verify what an agent did instead of trusting its summary.
10

Alternatives

⚡Top VS:
VSzcf★6.1k→VSsuede-creator-skills★121→VSspec-workflow-mcp★4.3k→VSContext7★65.2k→
zcf logo
zcf★ 6.1k
Zero-Config Code Flow for Claude code & Codex
VSCompare→
mastermind logo
mastermind★ 13
Local Rust codegraph and verifiable workflow for AI coding agents — project maps, change and test impact, MCP queries, and diff-backed implementation audits.
suede-creator-skills logo
suede-creator-skills★ 121
67 open-source Agent Skills for Claude Code and Codex: Full Send orchestration, A-F code review, AI evals, CI ship-gates, design, copy, SEO/AEO/GEO, app shipping, creator rights, and consumer recovery.
VSCompare→
spec-workflow-mcp logo
spec-workflow-mcp★ 4.3k
A Model Context Protocol (MCP) server that provides structured spec-driven development workflow tools for AI-assisted software development, featuring a real-time web dashboard and VSCode extension for monitoring and managing your project's progress directly in your development environment.
VSCompare→
Context7 logo
Context7★ 65.2k
MCP Server that provides up-to-date code documentation for LLMs and AI code editors.
VSCompare→
skills logo
skills★ 3.2k
Skills, MCP servers, Custom Agents, Agents.md for SDKs to ground Coding Agents
VSCompare→
loopover logo
loopover★ 22
The loop never sleeps — you finally can. Agents automate the entire development lifecycle (write, review, merge, learn) end to end, with a published safety record. Self-host today; rentable hosted loops in development. Any GitHub repo; Gittensor-native intelligence built in.
pal-mcp-server logo
pal-mcp-server★ 11.8k
The power of Claude Code / GeminiCLI / CodexCLI + [Gemini / OpenAI / OpenRouter / Azure / Grok / Ollama / Custom Model / All Of The Above] working as one.
VSCompare→
See all alternatives →

Featured in these lists

  • Best Claude Code Workflow Tools, Skills and Harnesses

Comments

Log in to leave a comment

No comments yet. Be the first!

On this page
01Features02Why choose it03Trade-offs05Maintenance check04Who it fits06How it differs07Compatibility08Quick start09Use cases10Alternatives
Gentleman-Programming /
gentle-ai
↗

Configurator that adds memory, skills, specs and guardrails to your coding agent

9.5k904MIT
Last commit1d ago
StatusActive
CategoryCode Assistant
Contributors103
Latest releasev4.6.0
Links
Documentation↗Discussion↗Issues↗Releases↗
Cloud Infrastructure
Ad

Deploy on DigitalOcean

Host your MCP servers, Docker containers, and AI agents with $200 free credit over 60 days.

Claim $200 Free Credit
© 2026 AgentIndex.app|Built by a 10-year iOS Developer.
Best by use caseAboutContactAdvertisePrivacy PolicyTerms of UseQYSGitHubBuy me a coffee ☕

Browse by Category

MCP ServersCode AssistantWorkflow AutomationRAG / Knowledge BaseMulti-AgentBrowser AutomationLLM InfraDev ToolingObservability

Not affiliated with Anthropic, OpenAI or Microsoft.