GitAgent CLI完全参考8个核心参数带你玩转命令行AI代理【免费下载链接】opengapA framework-agnostic, git-native standard for defining AI agents项目地址: https://gitcode.com/gh_mirrors/git/opengapGitAgent CLI 是一个 git 原生的命令行 AI 代理框架你的 AI 代理就是一个 git 仓库身份、规则、记忆、工具全部版本化管理。本文带你逐一拆解 GitAgent 命令行的 8 个核心参数--dir、--model、--prompt等从零开始玩转这个命令行 AI 代理附参数速查表和实战组合示例新手也能快速上手。 什么是 GitAgent把 AI 代理装进 git 仓库不同于把配置散落在应用代码里的传统框架GitAgent 的理念是agents as reposagent.yaml— 模型与工具配置SOUL.md— 代理人格与身份RULES.md— 行为约束memory/— 可 git 追溯的记忆skills/— 可组合的技能模块这意味着你可以 Fork 一个代理、为它开分支换性格、用git log查看它的记忆演化。仓库的目录结构定义见 README.md。⚡ 快速安装与第一行命令环境要求Node.js 20、npm、git。npm install -g open-gitagent/gitagent一行命令跑起你的第一个代理首次运行会自动生成agent.yaml、SOUL.md、memory/等脚手架文件并自动git initexport OPENAI_API_KEYsk-... gitagent --dir ~/my-agent 解释这个项目并给出改进建议 8个核心参数逐个拆解参数解析逻辑见 src/index.ts完整说明见 Documentation.md。1️⃣--dir-d指定代理目录告诉 GitAgent 你的代理仓库在哪里默认是当前目录gitagent --dir ~/assistant目录不存在时会自动创建并初始化缺什么脚手架就补什么新手零配置起步。2️⃣--model-m一键切换大模型格式为provider:model-id优先级高于agent.yaml中的默认配置gitagent -m anthropic:claude-sonnet-4-5-20250929 重构认证模块支持 anthropic、openai、google、xai、groq、mistral 等多家供应商切换模型只需改一个参数。3️⃣--prompt-p单次任务模式跳过交互式 REPL执行完一条指令就退出适合脚本化和 CI 自动化gitagent --dir ~/my-agent -p 列出所有 TypeScript 文件并总结不带--prompt时进入交互式 REPL可用/skills、/memory、/plugins、/tasks等斜杠命令管理会话。4️⃣--env-e切换环境配置加载config/env.yaml环境配置文件同一套代理可复用开发/生产等多套配置gitagent -e production 生成部署检查报告5️⃣--voice-v开启语音交互进入语音/网页 UI 模式浏览器打开http://localhost:3333可选openai或gemini后端gitagent --voice --dir ~/assistant gitagent --voice gemini --dir ~/assistant6️⃣--sandbox-s沙箱虚拟机执行让代理在 E2B 沙箱虚拟机中运行命令执行与本地文件系统隔离适合跑不可信任务gitagent --sandbox 运行这套数据处理脚本可配合--sandbox-repo指定仓库、--sandbox-token提供 E2B API 令牌默认读E2B_API_KEY环境变量。7️⃣--repo-r远程仓库自动克隆指定远程仓库 URLGitAgent 自动克隆到本地、在独立会话分支上工作完成后自动提交并推送gitagent --repo https://code.example.com/org/repo --pat ghp_xxx 修复登录 bugToken 也可通过GITHUB_TOKEN或GIT_TOKEN环境变量提供省去--pat。注意--repo与--sandbox互斥同时使用会直接报错退出。8️⃣--session断点续传恢复会话--repo模式会为每次会话生成独立分支用--session指定分支名即可从中断处继续干活gitagent --repo https://code.example.com/org/repo --pat ghp_xxx --session gitagent/session-a1b2c3d4 继续 参数速查表参数简写作用默认值--dir-d代理目录当前目录--model-m模型provider:model-idagent.yaml 配置--prompt-p单次任务跳过 REPL—--env-e环境配置config/env.yamldefault--voice-v语音/网页 UI可选 openai/gemini—--sandbox-sE2B 沙箱虚拟机false--repo-r克隆远程仓库并在会话分支工作—--session—恢复指定会话分支自动生成 加分项gitagent plugin install|list|enable|remove子命令可管理插件扩展--dir同样适用详见 plugin-cli.ts。 实战组合示例# 指定 Claude 模型 单次任务 gitagent -m anthropic:claude-sonnet-4-5-20250929 -p 审查 auth 模块的安全问题 # 沙箱中处理指定仓库 gitagent --sandbox --sandbox-repo https://code.example.com/org/repo 跑一遍测试 # 语音模式 指定目录 gitagent --voice --dir ~/assistant❓ 常见问题API key 没设置会怎样启动时会根据所选模型供应商检查对应环境变量如OPENAI_API_KEY、ANTHROPIC_API_KEY未设置会直接报错并提示修复命令不会进入半可用状态。代理的记忆存在哪里在memory/MEMORY.md通过 git 提交保存完整历史REPL 中输入/memory可随时查看当前记忆内容。更多细节插件、hooks、合规审计、遥测请查阅 Documentation.md 与 README.md。【免费下载链接】opengapA framework-agnostic, git-native standard for defining AI agents项目地址: https://gitcode.com/gh_mirrors/git/opengap创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考