@wx-sab/gitlab — gitlab-cli + gitlab skill

让 coding agent(Claude Code、Codex、TRAE 等)通过 gitlab-cli 命令代理 GitLab 常规操作:查项目、看/回 issue、提/合 MR、读写仓库文件、管理分支。

快速开始

# 一键安装:全局安装 CLI + 把 gitlab skill 复制到 agent 的 skill 目录
npx @wx-sab/gitlab setup

# 配置 GitLab 实例与 token
gitlab-cli auth login --url http://10.10.255.105 --token <你的PAT> --instance mycompany

# 验证
gitlab-cli auth status
gitlab-cli projects list --search my-project

# 备选:手动全局安装 CLI(然后运行 setup 只装 skill)
npm i -g @wx-sab/gitlab
gitlab-cli setup

内网环境:npx 需要能访问 npm registry。若无,请配置公司私有 registry,或从源码构建:

git clone <本仓库地址> && cd gitlab-cli && pnpm install && pnpm build && npm link

能力

| 组 | 命令 | 说明 | |----|------|------| | auth | login / logout / status | 多实例配置管理,token 校验 | | projects | list / get | 搜索/查看项目 | | issues | list / get / create / update / notes / comment | issue 全流程 | | mrs | list / get / create / update / merge / notes / comment | MR 全流程(含合入) | | repo | get-file / put-file / tree | 仓库文件读写 | | branches | list / create | 分支管理 | | users | search | 搜用户(评论 @ 人) | | setup | — | 一键安装 CLI + skill |

输出:默认 JSON(含 { data, pagination }),--format table 给人看。stdout 出数据,stderr 出错误。退出码:0 成功 / 1 参数错误 / 2 API 错误 / 3 未认证。

配置

配置文件 ~/.config/gitlab-cli/config.json(多实例):

{
  "instances": { "mycompany": { "url": "http://10.10.255.105", "token": "glpat-xxx" } },
  "current": "mycompany"
}

环境变量覆盖:GITLAB_URL + GITLAB_TOKEN 直接生效(CI 用);GITLAB_CLI_INSTANCE 选实例。

给 coding agent 使用

各项目把 gitlab-cli setup 装好的 gitlab skill 放进项目 .claude/skills/(或全局 ~/.claude/skills/)后,agent 会自动按 skill 指引操作 GitLab。

开发

pnpm install
pnpm lint && pnpm test && pnpm build

src/client/ 源自 gitlab-ai-worker/packages/shared,增强时注意两边同步。

发布

pnpm build
npm publish --registry <公司registry>