AI 编程助手已经很能写代码了。Claude Code、Codex、OpenCode 都可以读懂你的仓库、改好一个 Bug、补上一段测试。

但当任务走到「把这个分支提个 PR」「顺手建个仓库」「把这批 issue 归档」时，它们往往就卡住了——网页界面点不动，裸调 REST API 又要记住一堆端点、鉴权和分页规则。

Gitee CLI 正在补上这「最后一公里」：一个同时服务于人和 AI Agent 的命令行工具，已正式开源。

🔗https://gitee.com/oschina/gitee-cli

先服务开发者：一个终端搞定 Gitee 日常

对开发者来说，Gitee CLI 把最常做的研发操作从浏览器搬回了终端，只需一个 gitee 命令即可。

覆盖范围很务实：PR 的创建、查看、编辑、diff、approve、评论、合并、关闭、重开，甚至可以把 PR checkout 或 fetch 到本地；Issue 的列出、查看、创建、编辑、指派、评论、关闭和重开；仓库的列出、查看、创建、fork、克隆和删除；Release 和搜索也同样覆盖。

如果喜欢可视化操作，gitee config set tui true 可以开启 TUI——列表变成可交互表格，按键即可预览正文、查看 PR diff、复制链接或把 PR 拉到本地。新手不必先背完参数，熟练用户则可以直接用命令和 flag 完成操作。

遇到暂时没有一级命令覆盖的场景，gitee api 仍然提供原始 API 入口。更重要的是，gitee api --search 会从接口 Schema 中搜索端点，返回请求方法、路径和参数信息——里程碑、标签、协作者、Webhook 等长尾需求，因此不必靠记忆猜接口。

为什么同一套 CLI 也适合 Agent

让 Agent「能运行命令」并不难，难的是让命令可预测、结果可解析、执行不阻塞。Gitee CLI 为 Agent 场景做了六项关键设计：

1. 明确关闭交互：全局 --no-tui 会关闭 TUI，避免 Agent 停在交互式列表或分页器里。对写操作，Agent 还需要同时显式传入标题、正文等参数，避免命令转而打开编辑器等待输入。

2. 结构化输出：列表和查看类命令普遍支持 --json，还可以只选择需要的字段。Agent 拿到的是可直接解析的数据，不必从为人排版的表格里猜哪一列是什么。

3. 显式指定目标：PR 与 Issue 命令可用 --repo owner/repo 明确仓库；全局 --hostname 则用于选择 Gitee Host。无论是在仓库目录之外运行，还是同时使用 gitee.com 与私有部署，都不必依赖含糊的环境推断。

4. 诊断与结果分离：正式结果写入 stdout，诊断信息写入 stderr；--quiet 与 --verbose 控制输出强度。管道里的 JSON 不会被调试日志污染。

5. API 兜底：gitee api 可以调用已公开的 Gitee V5 API，--search 则帮助 Agent 先发现接口 Schema，再确定请求方法、路径和参数。

6. 适配 CI 和无人值守环境：使用 Personal Access Token（PAT）认证，既可以从标准输入读取 Token，也支持通过环境变量提供凭证。

Agent Skills：把「会用」变成「用对」

CLI 解决「能不能做」，Agent Skills 解决「怎样做才稳定、可控」。这是一套给 AI 助手的结构化操作手册，Claude Code、Codex、OpenCode 等支持 Agent Skills 的助手都能直接加载。

Gitee CLI v0.2.2 内置六个 Agent Skills：gitee-pr、gitee-issue、gitee-release、gitee-repo、gitee-search、gitee-api。每个 Skill 都遵守四条底线：关闭交互界面（--no-tui）、优先结构化输出（--json）、不嵌套调用交互式 AI、高影响操作必须显式确认（合并 PR、删除仓库等操作，要先完整展示「将要做什么」，等用户确认后再执行）。

安装方式：gitee skills install，命令会把这些 Skill 镜像到 ~/.agents/skills/，无需联网即可安装或更新。

一次完整的 Agent 工作流

假设你刚写完一个功能分支，对 AI 助手说「帮我把这个分支提个 PR」，装了 Skills 的 Agent 会这样走完全程：

先运行 gitee auth status --json --no-tui 确认已登录；读取 git diff 和 git log，自己总结出 PR 的标题和正文——注意，是它自己写，而不是再调用可能进入交互流程的 --ai；然后执行 gitee pr create。

你说「看看改动」，它用 gitee pr diff 把 diff 拉给你；你说「通过并合并」，它先把 PR 编号、标题、分支和合并方式完整展示出来，等你确认后再执行合并。

完成认证后，全程可以不再打开网页。但最关键、难以撤销的那一步，始终交回到了用户手上。

Gitee CLI 以 MIT 协议开源，已发布 npm 包和 Shell 一键安装脚本。

参考来源：

• Gitee CLI 微信公众号文章
• Gitee CLI 开源仓库
• Agent Skills 目录