open-gitagent/gitagent

解决的问题

Gitagent 是一个用于创建 AI 智能体的框架，智能体的完整状态——包括其身份、规则、记忆和工具——都作为版本控制文件存储在 git 仓库中。这种“智能体即仓库”的方法允许用户像处理源代码一样对智能体的个性化和记忆进行 fork、分支和 diff。

工作原理

智能体由包含若干关键文件的特定目录结构定义：

• agent.yaml: 配置 LLM 模型、工具和运行时设置。
• SOUL.md 和 RULES.md: 定义智能体的个性和行为约束。
• memory/: 存储具有完整历史记录的 git 已提交记忆。
• tools/ 和 skills/: 包含声明式工具定义和可组合的指令模块。

Gitagent 可以通过 CLI、编程 TypeScript SDK 或语音 UI 运行。它还可以作为 MCP (Model Context Protocol) 客户端运行，允许它自动发现并使用来自任何 MCP 服务器的工具。

适用对象

• 希望对其 AI 智能体配置和行为演进进行版本控制的开发人员。
• 希望通过 git 共享和协作智能体个性及技能集的团队。
• 希望拥有能够与本地文件、Shell 命令和外部 MCP 服务器交互的多模态智能体的用户。

亮点

• Git 原生状态: 身份、记忆和规则都是版本控制文件。
• MCP 集成: 原生支持任何 MCP 服务器，实现即时工具扩展。
• 可扩展架构: 支持插件、自定义声明式工具和编程生命周期钩子。
• 灵活部署: 提供精简的 CLI、用于进程内集成的完整 SDK 以及支持语音的 Web UI。