Repolode
open-gitagent

open-gitagent/gitagent

一个 Git 原生的 AI Agent 框架,把 Agent 的身份、规则、记忆、工具和技能都存为可版本控制的文件。

Star
720
Fork
138
未关闭 Issue
60
最近提交
7小时前

这是什么?

Gitagent 把 AI Agent 本身定义为一个 Git 仓库。Agent 的人设(SOUL.md)、行为规则(RULES.md)、记忆(memory/)、YAML 声明式工具、可组合的技能和生命周期钩子都是普通文件,因此可以用常规 git 命令进行 fork、分支、diff 和查看历史。

项目提供命令行工具 `gitagent` 和一个以流式 `query()` 函数为核心的 SDK。CLI 既可以针对本地目录运行,也可以克隆 GitHub 仓库,在会话分支上工作并自动提交、推送。模型调用基于 pi-ai,支持 Anthropic、OpenAI、Google、xAI、Groq、Mistral 等提供商,并可在 agent.yaml 中配置备用模型。

此外,它还能作为 MCP 客户端,通过 stdio 或 HTTP 接入 MCP 服务器的工具;同时支持插件、子 Agent 委派、合规配置(审计日志写入 .gitagent/audit.jsonl)以及可选的 OpenTelemetry 链路追踪。

核心功能

  • 01Agent 的身份、规则、记忆和工具以受 git 版本控制的文件形式保存。
  • 02提供流式 SDK(query()),可通过钩子拦截或修改工具调用。
  • 03既可针对本地目录运行,也可克隆 GitHub 仓库并在会话分支上工作。
  • 04作为 MCP 客户端,自动注册已配置 MCP 服务器的工具。
  • 05支持 YAML 声明式工具、技能和插件。
  • 06可选 OpenTelemetry 链路追踪与审计日志。

适用场景

  • 维护个人或团队的 AI 助手,通过 git diff 审查其规则和记忆变化。
  • 以基础 Agent 为起点 fork,并分支出不同人设或规则版本。
  • 让 Agent 在 GitHub 仓库的会话分支上完成修复任务。
  • 通过 query() SDK 在 Node.js 应用中嵌入 Agent 并接入自定义工具。

标签

常见问题

gitagent 是什么?
一个 Git 原生的 AI Agent 框架,把 Agent 的身份、规则、记忆、工具和技能都存为可版本控制的文件。 Gitagent 把 AI Agent 本身定义为一个 Git 仓库。Agent 的人设(SOUL.md)、行为规则(RULES.md)、记忆(memory/)、YAML 声明式工具、可组合的技能和生命周期钩子都是普通文件,因此可以用常规 git 命令进行 fork、分支、diff 和查看历史。
gitagent 可以免费使用吗?用的什么许可证?
gitagent 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
gitagent 还在维护吗?
活跃维护中。gitagent 最近一次提交是在 2026年10月22日。
gitagent 适合用来做什么?
维护个人或团队的 AI 助手,通过 git diff 审查其规则和记忆变化。 以基础 Agent 为起点 fork,并分支出不同人设或规则版本。 让 Agent 在 GitHub 仓库的会话分支上完成修复任务。 通过 query() SDK 在 Node.js 应用中嵌入 Agent 并接入自定义工具。
在哪里获取 gitagent?
源代码和安装说明在 GitHub 上:https://github.com/open-gitagent/gitagent

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目