Gitee CLI Skill

Use the gitee CLI to interact with Gitee repositories, issues, PRs, and repos.

Requirements

• The gitee CLI tool must be installed and available in the system PATH.
• Run gitee auth status to verify login before performing actions.

When to Use

✅ USE this skill when:

• Checking PR status, reviews, or merge readiness
• Creating, closing, or commenting on issues
• Creating or merging pull requests
• Managing repositories (view, clone, fork)
• Viewing PR diffs for code review

When NOT to Use

❌ DON'T use this skill when:

• GitHub operations → use github skill with gh CLI
• Local git operations (commit, push, pull, branch) → use git directly
• Non-Gitee repos (GitHub, GitLab) → different CLIs
• Cloning repositories → use git clone

Setup

# Verify
gitee auth status

Common Commands

Authentication

# Login
gitee auth login -t=<token>

# Logout
gitee auth logout

# Check status
gitee auth status

Pull Requests

# List PRs
gitee pr list --repo owner/repo

# View PR details
gitee pr view 55 --repo owner/repo

# View PR diff (for code review)
gitee pr diff 55 --repo owner/repo

# Create PR
gitee pr create -t "feat: add feature" -H head-branch -B main --repo owner/repo

# Merge PR
gitee pr merge 55 --repo owner/repo

# Close/Reopen PR
gitee pr close 55 --repo owner/repo
gitee pr reopen 55 --repo owner/repo

Issues

# List issues
gitee issue list --repo owner/repo --state open

# Create issue
gitee issue create -t "Bug: something broken" -b "Details..." --repo owner/repo

# View issue
gitee issue view 42 --repo owner/repo

# Comment on issue
gitee issue comment 42 -b "Comment text" --repo owner/repo

# Close issue
gitee issue close 42 --repo owner/repo

Repositories

# View repo info
gitee repo view --repo owner/repo

# Clone repo
gitee repo clone --repo owner/repo

# Fork repo
gitee repo fork --repo owner/repo

Global Options

• --debug - Enable debug mode
• --json - JSON output
• -R, --repo=<repo> - Specify repository (format: OWNER/REPO)
• -h, --help - Help
• -V, --version - Version

JSON Output

Most commands support JSON output:

gitee issue list --repo owner/repo --json
gitee pr list --repo owner/repo --json

Notes

• Always specify --repo owner/repo when not in a git directory
• Use --json for structured output parsing
• Token can also be set via gitee config set token <token>