Skip to content

About

Gitee Open API CLI — manage Gitee repos, issues, PRs, releases from your terminal; ships as a Claude Code skill

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

8 Commits

Folders and files

Repository files navigation

Gitee Open API CLI

在终端中管理 Gitee 仓库、Issue、PR、Release 等资源的命令行工具。

安装

# 克隆仓库
git clone git@gitee.com:karryup/GiteeOpenAPI.git
cd GiteeOpenAPI

# 安装依赖
npm install

# 注册全局命令
npm link

或者通过 npx 直接使用:

npx tsx src/index.ts --help

安装 Claude Code Skill

# 从项目目录直接安装(推荐)
bash scripts/install-skill.sh

# 或在新主机上一键拉取并安装:
# bash <(curl -s https://gitee.com/karryup/GiteeOpenAPI/raw/main/scripts/install-skill.sh)

安装后在 Claude Code 中使用 /gitee <command>。

快速开始

# 配置 Personal Access Token
gitee auth login <your_token>

# 查看当前用户
gitee user

# 列出仓库
gitee repo list

Token 可以从 https://gitee.com/profile/personal_access_tokens 生成。

命令参考

认证

命令 说明
gitee auth login <token> 保存 Token
gitee auth status 查看认证状态
gitee auth logout 移除 Token

仓库管理

命令 说明
gitee repo list [options] 列出仓库(支持 --type, --page, --per-page)
gitee repo view <owner/repo> 查看仓库详情
gitee repo create <name> 创建仓库(--private, --init, --description)
gitee repo delete <owner/repo> 删除仓库(交互式确认,-y 跳过)
gitee repo star <owner/repo> Star 仓库
gitee repo unstar <owner/repo> 取消 Star
gitee repo stargazers <owner/repo> 查看 Star 用户

Issue 管理

命令 说明
gitee issue list <owner/repo> 列出 Issue(--state, --page)
gitee issue view <owner/repo> <number> 查看 Issue
gitee issue create <owner/repo> <title> 创建 Issue(--body, --assignee, --labels)
gitee issue close <owner/repo> <number> 关闭 Issue

Pull Request 管理

命令 说明
gitee pr list <owner/repo> 列出 PR(--state, --page)
gitee pr view <owner/repo> <number> 查看 PR
gitee pr create <owner/repo> <title> 创建 PR(--head, --base, --body)
gitee pr merge <owner/repo> <number> 合并 PR(--message)

Release 管理

命令 说明
gitee release list <owner/repo> 列出 Releases(--page)
gitee release create <owner/repo> <tag> 创建 Release(--title, --body, --prerelease)
gitee release delete <owner/repo> <id> 删除 Release(交互式确认,-y 跳过)

分支管理

命令 说明
gitee branch list <owner/repo> 列出分支
gitee branch view <owner/repo> <branch> 查看分支详情
gitee branch create <owner/repo> <name> 创建分支(--ref)
gitee branch delete <owner/repo> <branch> 删除分支(交互式确认)

标签管理

命令 说明
gitee tag list <owner/repo> 列出标签
gitee tag create <owner/repo> <name> 创建标签(--ref)
gitee tag delete <owner/repo> <name> 删除标签(交互式确认)

搜索

命令 说明
gitee search repos <query> 搜索仓库(--sort, --page)
gitee search issues <query> 搜索 Issue(--repo, --page)
gitee search prs <query> 搜索 PR(--repo, --page)

Commit 管理

命令 说明
gitee commit list <owner/repo> 列出提交(--sha, --path, --page)
gitee commit view <owner/repo> <sha> 查看提交详情

Webhook 管理

命令 说明
gitee hook list <owner/repo> 列出 Webhook
gitee hook create <owner/repo> 创建 Webhook(--url, --push, --issues)
gitee hook delete <owner/repo> <id> 删除 Webhook(交互式确认)

Gitee Pages

命令 说明
gitee pages show <owner/repo> 查看 Pages 配置
gitee pages deploy <owner/repo> 部署 Pages(--branch, --build-type)

Shell 补全

# 配置 bash 补全
source <(gitee completion bash)

# 配置 zsh 补全
echo 'autoload -Uz bashcompinit && bashcompinit' >> ~/.zshrc
echo 'source <(gitee completion bash)' >> ~/.zshrc
source ~/.zshrc

通用选项

  • --json — 所有 list 和 view 命令支持 JSON 格式输出
  • --page <n> — 分页页码
  • --per-page <n> — 每页数量(最大 100)

环境变量

变量 说明
GITEE_TOKEN 优先于配置文件,适合 CI/CD 场景

开发

# TypeScript 编译检查
npm run build

# 开发模式
npm run dev -- --help

License

MIT

About

Gitee Open API CLI — manage Gitee repos, issues, PRs, releases from your terminal; ships as a Claude Code skill

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages