用途：Git Agent CLI 面向编码智能体的 Git 工作，默认以裸命令 git-agent 作为自主工作流入口，自动检查仓库并执行提交流程。
主要能力：支持原子提交，可将改动拆分为最多 5 个逻辑独立的提交，每个提交都经过钩子校验；自动从 Git 历史生成提交 scope；可通过 init --scope --force 依据最新历史重新生成 scope，通过 init --gitignore 在保留自定义规则的前提下重新推导 .gitignore；内置 conventional-commit 校验，并支持通过 shell 脚本添加自定义钩子；所有读取命令支持 -o json 结构化输出，便于脚本处理。
使用方式：默认使用裸命令，提交分两步。先收集上下文：使用 harness 的 session-context 工具（如 pi 中的 session_context）收集上次提交以来的用户请求与决策；若没有该工具，则自行读取 diff。再将上下文浓缩为一句简洁的意图描述，说明改了什么以及为什么，不要使用原始文件列表或 diff 转储。然后执行：git-agent --intent "<one-sentence intent assembled from the gathered context>"。不要默认使用 git-agent commit，该子命令仅用于明确的提交场景。运行任何命令前，应先从 CLI 加载实际工作流内容：git-agent skills get core。可用文档包括：git-agent skills get core（主使用指南，含触发条件、工作流、标志、退出码）、git-agent skills get cli（完整命令参考，含所有标志、子命令、配置作用域、钩子类型）、git-agent skills list（列出所有文档）。
配置优先级：CLI 标志 > git config --local > ~/.config/git-agent/config.yml > 免费共享网关默认值；--free 强制使用网关并忽略其余配置。智能体会话环境变量（PI_MODEL、CLAUDE_CODE_MODEL、CODEX_MODEL）不会设置推理模型，推理模型仅从标志、本地 git 配置或用户配置解析；会话模型单独读取，用于 Co-Authored-By 署名。
限制：该工具在线且依赖 LLM；官方发行版提供共享网关，无需个人 API 密钥。资料未提供收费、价格、平台支持范围及具体效果数据。