gentle-ai

一次配置，让多个 AI 编码代理共享记忆与技能

开源 free 编程开发

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 7653

维护状态活跃

是否开源是

定价模式 free

项目预览

项目数据

分类编程开发

开发团队Gentleman-Programming

所属国家

官网地址https://gentle-ai.gentlemanprogramming.com

GitHubhttps://github.com/Gentleman-Programming/gentle-ai

定价模式free

价格说明开源免费，无付费计划

访问状态

是否开源是

开源协议MIT

主要语言Go

技术栈/模型agent-skills,ai-agents,ai-coding,claude-code,code-review,codex,coding-agents,copilot,cursor,developer-tools,golang,llm,mcp,opencode,persistent-memory,pi,spec-driven-development

GitHub 星标★ 7653

30天Star增速

HF 下载量

上线时间2026-02-27 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-10-11

浏览次数0

项目介绍

Gentle-AI 是一个用 Go 编写的开源配置层，专门用来统一管理你已经在用的 AI 编程代理，比如 Claude Code、Cursor、OpenCode、Codex、Pi 等。它解决的核心问题是：不同 AI 编码工具各自为政，记忆、技能、人设、MCP 服务器和审查规则都要重复配置，切换工具时上下文丢失。Gentle-AI 把这些能力抽象成可复用的配置，让代理获得持久记忆、Organic-Driven Development 工作流、精选技能包、MCP 服务器接入、角色人设以及可选的有界代码审查。它不绑定任何单一代理，你换工具时配置和记忆可以延续。项目语言为 Go，星标约 7600，属于成长中的开发者工具，适合同时使用多个 AI 编码代理、希望统一工作流并保留长期上下文的工程师。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度：入门约 10 分钟部署方式：命令行工具 5 步

环境要求

Go 1.25.10 或更高版本（源码安装最新 release 所需）
可用的终端：Windows PowerShell 或同等 shell
已自行安装好要配置的 AI 编程代理（Claude Code、Cursor、OpenCode、Codex、Pi 等）
能访问 GitHub 以拉取安装模块

安装与启动步骤

1确认 Go 版本

安装前先确认本机 Go 版本不低于 1.25.10，否则 go install 会失败。
```
go version
```
2源码安装 gentle-ai

用 go install 拉取并构建 v4.0.0 版本，二进制会装到 Go 的 bin 目录。
```
go install github.com/gentleman-programming/gentle-ai/v4/cmd/gentle-ai@v4.0.0
```
3运行初始化配置

直接执行会进入交互选择，挑选你的代理、需要的组件和人设。
```
gentle-ai
```
4用 doctor 校验

doctor 为只读检查，不会改动任何文件，用来确认安装与状态文件正常。
```
gentle-ai doctor
```
5正常使用你的代理

配置完成后照常使用原有的 AI 代理即可，Gentle-AI 只做配置层。

如何确认成功

运行 gentle-ai doctor，只读校验通过且不报 state.json 读取错误，即表示安装配置成功。

常见问题

Q：doctor 读不到 state.json 怎么办？

A：先查看报错指向的文件及其父目录访问权限；若是权限问题，检查权限与属主。保留原有 state.json，不要删除。

Q：state.json 内容不是合法 JSON 怎么办？

A：用有效的备份恢复，或在保留原有安装设置的前提下修复内容，然后重新运行 gentle-ai doctor；doctor 不会改动该文件或其权限。

Q：Gentle-AI 会帮我安装 AI 代理吗？

A：不会。它只配置你已经装好的代理，不会替你安装任何 AI 代理。

Q：配置被改坏了能回滚吗？

A：每次写入前配置都会被自动快照，可借助快照恢复到之前的状态。

注意事项

源码安装需要 Go 1.25.10+，版本不足请先升级 Go。
README 仅给出源码安装方式，其他安装方式需查看 Quickstart 文档。
Beta 通道和各发行版的前置依赖见 docs/quickstart.md。
签名验证方法见 docs/release-signing.md 的用户验证章节。

核心亮点

不锁定单一代理，Claude Code、Cursor、Codex 等可共用同一套记忆和技能配置
提供持久记忆与 Organic-Driven Development 工作流，减少每次对话重复交代背景
内置精选技能、MCP 服务器、人设和可选有界审查，开箱即用程度较高

不足之处

项目仍在成长阶段，生态和第三方技能市场尚不成熟
多代理统一配置的抽象层可能增加调试复杂度，出问题需排查代理与配置两层

适用场景

同时使用 Claude Code 和 Cursor 的开发者，希望记忆与技能跨工具同步
团队想统一 AI 编码代理的审查规则和人设，避免每人各配一套
需要给 AI 代理接入 MCP 服务器并管理长期项目上下文的工程场景

替代项目

aider、continue

上一篇：Trellis

下一篇：ZCode