oh-gc CLI — GitCode Command Line Tool

oh-gc CLI — GitCode 命令行工具

Version: 0.7.4 | Updated: 2026-04-10

oh-gc

is a CLI for GitCode, modeled after GitHub CLI (

gh

). Manages authentication, issues, pull requests, releases, and repo configuration from the terminal.

Package:

npm install -g @oh-gc/cli

(requires Node.js 18+)

版本： 0.7.4 | 更新时间： 2026-04-10

oh-gc

是一个用于 GitCode 的 CLI，其设计参考 GitHub CLI (

gh

)。可在终端管理身份验证、Issue、Pull Request、Release 和仓库配置。

软件包：

npm install -g @oh-gc/cli

（需要 Node.js 18+）

⚠️ MANDATORY FIRST STEP — DO NOT SKIP

⚠️ 强制第一步 — 不得跳过

Run
oh-gc --version
as the VERY FIRST command before ANY other oh-gc command.

If not found →
```
npm install -g @oh-gc/cli@{version}
```
(use the version shown at the top of this document)
If the version does not match {version} →
```
npm install -g @oh-gc/cli@{version}
```
to install the exact matching version
Do NOT run
oh-gc auth
,
oh-gc issue
,
oh-gc pr
, or any other command until the version is confirmed matching.

在执行任何其他 oh-gc 命令之前，必须首先运行
oh-gc --version
。

如果未找到 →
```
npm install -g @oh-gc/cli@{version}
```
（使用本文档顶部显示的版本）
如果版本与 {version} 不匹配 →
```
npm install -g @oh-gc/cli@{version}
```
，以安装完全匹配的版本
在确认版本匹配之前，不要运行
oh-gc auth
、
oh-gc issue
、
oh-gc pr
或任何其他命令。

Prerequisites

前置条件

After confirming the version matches, check the following:

Token configured? Run
```
oh-gc auth status
```
- If not logged in →
```
oh-gc auth login
```
  (prompts for GitCode personal access token)
- Token obtained at: GitCode → 个人设置 → 访问令牌
Repository context? Either:
- Inside a git repo with a
```
gitcode.com
```
  remote (remote name configurable via
```
oh-gc repo set-remote <name>
```
  ), OR
- Use
```
--repo owner/repo
```
  flag to specify any repository

确认版本匹配后，检查以下事项：

是否已配置 Token？ 运行
```
oh-gc auth status
```
- 如果未登录 →
```
oh-gc auth login
```
  （会提示输入 GitCode 个人访问令牌）
- 获取 Token 的位置：GitCode → 个人设置 → 访问令牌
是否有仓库上下文？ 以下方式任选其一：
- 位于一个带有
```
gitcode.com
```
  remote 的 git 仓库中（remote 名称可通过
```
oh-gc repo set-remote <name>
```
  配置），或者
- 使用
```
--repo owner/repo
```
  参数指定任意仓库

Global Flags

全局参数

All commands support:

```
--json
```
— output raw JSON instead of formatted table
```
--help
```
— show command help

所有命令均支持：

```
--json
```
— 输出原始 JSON，而非格式化表格
```
--help
```
— 显示命令帮助

Repository Flag

仓库参数

Most commands that operate on a repository support the

--repo

flag, which allows specifying a target repository without being inside a git clone:

```
--repo owner/repo
```
— target repository in OWNER/REPO format

This is useful for:

Operating on repositories you haven't cloned locally
Cross-repo operations (e.g., creating a PR from fork to upstream)
CI/CD scripts that need to interact with multiple repositories

bash

undefined

大多数需要在仓库上执行操作的命令都支持

--repo

参数，无需进入 git clone 即可指定目标仓库：

```
--repo owner/repo
```
— 以 OWNER/REPO 格式指定目标仓库

这适用于：

操作尚未在本地克隆的仓库
跨仓库操作（例如，从 Fork 向 upstream 创建 PR）
需要与多个仓库交互的 CI/CD 脚本

bash

undefined

List issues in any repository

oh-gc issue list --repo openharmony/arkui_ace_engine

Create an issue without cloning

oh-gc issue create --repo owner/repo --title "Bug report"

View a PR on another repo

oh-gc pr view 123 --repo owner/repo

Cross-repo PR (fork to upstream) — use owner:branch for --head

oh-gc pr create --repo upstream-owner/repo --head myname:my-feature --base main

undefined

oh-gc pr create --repo upstream-owner/repo --head myname:my-feature --base main

undefined

Command Reference

命令参考

Authentication

身份验证

bash

oh-gc auth login          # Log in with personal access token (interactive prompt)
oh-gc auth logout         # Remove stored token
oh-gc auth status         # Show current user info

Token stored at

~/.config/gitcode-cli/config.json

.

bash

oh-gc auth login          # Log in with personal access token (interactive prompt)
oh-gc auth logout         # Remove stored token
oh-gc auth status         # Show current user info

Token 存储在

~/.config/gitcode-cli/config.json

中。

Issues

Issue

bash

undefined

bash

undefined

List

oh-gc issue list # Open issues (default) oh-gc issue list --state closed # Closed issues oh-gc issue list --state all # All issues oh-gc issue list --assignee alice # Filter by assignee oh-gc issue list --search "login bug" # Search by keyword oh-gc issue list --limit 50 # Max results (default: 30)

View

oh-gc issue view 12 # Show issue detail + recent comments

Create

oh-gc issue create # Interactive mode oh-gc issue create --title "Bug" --body "..." # With flags oh-gc issue create --repo owner/repo --title "Bug" # On another repo oh-gc issue create --assignee alice --labels "bug,P0" # With metadata

Comment

oh-gc issue comment 12 # Interactive prompt oh-gc issue comment 12 --body "Confirmed" # With flag

Close/Reopen

oh-gc issue close 12 # Close an issue oh-gc issue reopen 12 # Reopen a closed issue

Labels

oh-gc issue labels 12 bug,feature # Add labels oh-gc issue labels 12 bug --remove # Remove label

History

oh-gc issue history 12 # View modification history of an issue

Reactions

oh-gc issue reactions 12 # List emoji reactions on issue

Linked PRs

oh-gc issue prs 12 # List PRs linked to an issue oh-gc issue prs 12 --mode 1 # Only mergeable PRs

Related branches

oh-gc issue branches 12 # List branches related to an issue oh-gc issue branches 12 --set feature-x,fix-y # Set related branches

Comment management

oh-gc issue comment-get <id> # Get a single comment oh-gc issue comment-edit <id> --body "new" # Edit a comment oh-gc issue comment-delete <id> # Delete a comment oh-gc issue comment-history <id> # View comment edit history oh-gc issue comment-reactions <id> # List reactions on a comment

undefined

oh-gc issue comment-get <id> # Get a single comment oh-gc issue comment-edit <id> --body "new" # Edit a comment oh-gc issue comment-delete <id> # Delete a comment oh-gc issue comment-history <id> # View comment edit history oh-gc issue comment-reactions <id> # List reactions on a comment

undefined

Pull Requests

Pull Request

bash

undefined

bash

undefined

List

oh-gc pr list # Open PRs (default) oh-gc pr list --state merged # Merged PRs oh-gc pr list --state all # All PRs oh-gc pr list --author alice # Filter by author oh-gc pr list --reviewer bob # Filter by reviewer oh-gc pr list --assignee carol # Filter by assignee oh-gc pr list --limit 50 # Max results (default: 30)

View

oh-gc pr view 5 # Show PR detail

Create

oh-gc pr create # Interactive mode oh-gc pr create --title "Fix bug" --base main # From current branch oh-gc pr create --head feature --base main --draft # Draft PR oh-gc pr create --repo owner/repo --head myname:feature # Cross-repo PR (fork→upstream, use owner:branch)

Update

oh-gc pr update 5 --title "New title" # Update title oh-gc pr update 5 --body "New description" # Update body oh-gc pr update 5 --state closed # Close PR oh-gc pr update 5 --state open # Reopen PR oh-gc pr update 5 --draft # Mark as draft oh-gc pr update 5 --labels "bug,wip" # Set labels

Close/Reopen

oh-gc pr close 5 # Close a PR oh-gc pr reopen 5 # Reopen a closed PR

Diff

oh-gc pr diff 5 # Show full diff with colors oh-gc pr diff 5 --name-only # Only changed file names oh-gc pr diff 5 --color never # No color (for piping)

Merge

oh-gc pr merge 5 # Merge commit (default) oh-gc pr merge 5 --method squash # Squash merge oh-gc pr merge 5 --method rebase # Rebase merge

Comment

oh-gc pr comment 5 --body "LGTM!" # General comment oh-gc pr comment 5 --body "Fix this" --path src/main.ts --line 10 # Line comment oh-gc pr comment 5 --repo owner/repo --body "Note" # On another repo

List/delete comments

oh-gc pr comments 5 # List all comments oh-gc pr comments 5 --limit 10 --latest # Latest 10 comments first oh-gc pr comments 5 --full-body # Show full comment bodies oh-gc pr comments 5 --comment-type diff_comment # Only diff/line comments oh-gc pr comments 5 --comment-type pr_comment # Only general comments oh-gc pr comments 5 --delete 12345 # Delete by note_id

Reactions

oh-gc pr reactions 5 # List emoji reactions on PR

Commits

oh-gc pr commits 5 # List commits in PR

Reviewers

oh-gc pr reviewers 5 alice,bob # Assign reviewers oh-gc pr reviewers 5 alice --append # Add to existing reviewers oh-gc pr reviewers 5 alice --remove # Remove reviewer

Testers

oh-gc pr testers 5 alice,bob # Assign testers oh-gc pr testers 5 alice --append # Add to existing testers oh-gc pr testers 5 alice --remove # Remove tester

Review & Test approval

oh-gc pr review 5 # Approve PR review oh-gc pr review 5 --force # Force approve oh-gc pr test 5 # Mark test passed oh-gc pr test 5 --force # Force mark

Labels

oh-gc pr labels 5 bug,enhancement # Add labels oh-gc pr labels 5 bug --remove # Remove label oh-gc pr labels 5 bug,feature --replace # Replace all labels

Link issues

oh-gc pr link 5 1,2,3 # Link issues to PR oh-gc pr link 5 1,2 --remove # Unlink issues

Operation logs

oh-gc pr logs 5 # Show PR operation history

Files

oh-gc pr files 5 # List changed files in PR

History

oh-gc pr history 5 # View PR modification history

Linked issues

oh-gc pr linked-issues 5 # List issues linked to PR

Assignees

oh-gc pr assignees 5 --add alice,bob # Assign users oh-gc pr assignees 5 --reset # Reset assignee status oh-gc pr assignees 5 --reset --all # Reset all assignees oh-gc pr assignees 5 --remove alice # Remove assignee

PR settings

oh-gc pr settings # View repo PR settings oh-gc pr settings-update --merge-method squash --delete-branch-on-merge # Update settings

Option reviewers

oh-gc pr option-reviewers 5 # List users eligible to review

Comment management

oh-gc pr comment-get <id> # Get a single PR comment oh-gc pr comment-edit <id> --body "new" # Edit a PR comment oh-gc pr comment-delete <id> # Delete a PR comment oh-gc pr comment-history <id> # View comment edit history oh-gc pr comment-reactions <id> # List reactions on a comment

undefined

oh-gc pr comment-get <id> # Get a single PR comment oh-gc pr comment-edit <id> --body "new" # Edit a PR comment oh-gc pr comment-delete <id> # Delete a PR comment oh-gc pr comment-history <id> # View comment edit history oh-gc pr comment-reactions <id> # List reactions on a comment

undefined

Releases

Release

bash

oh-gc release create                          # Use version from package.json
oh-gc release create v1.0.0                   # Specific version
oh-gc release create --prerelease             # Mark as prerelease
oh-gc release create v1.0.0 --notes "..."     # Custom release notes

bash

oh-gc release create                          # Use version from package.json
oh-gc release create v1.0.0                   # Specific version
oh-gc release create --prerelease             # Mark as prerelease
oh-gc release create v1.0.0 --notes "..."     # Custom release notes

Repo Configuration

仓库配置

bash

oh-gc repo list                               # List your repositories
oh-gc repo list --org myorg                   # List org repositories
oh-gc repo create myrepo                      # Create a new repository
oh-gc repo create myrepo --org myorg          # Create under an org
oh-gc repo delete --yes                       # Delete current repo (no prompt)
oh-gc repo fork                               # Fork current repo to your account
oh-gc repo fork --org myorg                   # Fork into an organization
oh-gc repo forks                              # List forks of current repo
oh-gc repo settings                           # View repo advanced settings
oh-gc repo settings --disable-fork           # Update a setting
oh-gc repo languages                          # Show language breakdown
oh-gc repo contributors                       # List contributors
oh-gc repo contributors --stats               # Show detailed contribution stats
oh-gc repo events                             # List repository events
oh-gc repo events --filter push               # Filter by event type
oh-gc repo stats --branch main                # Commit stats per author
oh-gc repo stats --downloads                  # Download stats by date
oh-gc repo archive --password secret          # Archive a repository
oh-gc repo archive --open --password secret   # Unarchive a repository
oh-gc repo transition                         # View permission inheritance mode
oh-gc repo transition --mode 2               # Set to independent mode
oh-gc repo module --wiki --issues            # Enable wiki and issues modules
oh-gc repo module --no-fork                  # Disable fork module
oh-gc repo roles                              # List customized roles
oh-gc repo list --user alice                  # List user's public repos
oh-gc repo list --visibility private          # List private repositories
oh-gc repo get-remote                         # Show which remote oh-gc uses
oh-gc repo set-remote upstream                # Use a different remote
oh-gc repo view                               # View repository info
oh-gc repo update --description "..."         # Update repository settings
oh-gc repo transfer <new-owner>               # Transfer repository ownership

Remote override stored at

.gitcode/oh-gc-config.json

in repo root.

bash

oh-gc repo list                               # List your repositories
oh-gc repo list --org myorg                   # List org repositories
oh-gc repo create myrepo                      # Create a new repository
oh-gc repo create myrepo --org myorg          # Create under an org
oh-gc repo delete --yes                       # Delete current repo (no prompt)
oh-gc repo fork                               # Fork current repo to your account
oh-gc repo fork --org myorg                   # Fork into an organization
oh-gc repo forks                              # List forks of current repo
oh-gc repo settings                           # View repo advanced settings
oh-gc repo settings --disable-fork           # Update a setting
oh-gc repo languages                          # Show language breakdown
oh-gc repo contributors                       # List contributors
oh-gc repo contributors --stats               # Show detailed contribution stats
oh-gc repo events                             # List repository events
oh-gc repo events --filter push               # Filter by event type
oh-gc repo stats --branch main                # Commit stats per author
oh-gc repo stats --downloads                  # Download stats by date
oh-gc repo archive --password secret          # Archive a repository
oh-gc repo archive --open --password secret   # Unarchive a repository
oh-gc repo transition                         # View permission inheritance mode
oh-gc repo transition --mode 2               # Set to independent mode
oh-gc repo module --wiki --issues            # Enable wiki and issues modules
oh-gc repo module --no-fork                  # Disable fork module
oh-gc repo roles                              # List customized roles
oh-gc repo list --user alice                  # List user's public repos
oh-gc repo list --visibility private          # List private repositories
oh-gc repo get-remote                         # Show which remote oh-gc uses
oh-gc repo set-remote upstream                # Use a different remote
oh-gc repo view                               # View repository info
oh-gc repo update --description "..."         # Update repository settings
oh-gc repo transfer <new-owner>               # Transfer repository ownership

Remote 覆盖配置存储在仓库根目录的

.gitcode/oh-gc-config.json

中。

Search

搜索

bash

oh-gc search repos "keyword"                  # Search repositories
oh-gc search issues "keyword"                 # Search issues across repos
oh-gc search code "keyword"                   # Search code across repos

bash

oh-gc search repos "keyword"                  # Search repositories
oh-gc search issues "keyword"                 # Search issues across repos
oh-gc search code "keyword"                   # Search code across repos

User

用户

bash

oh-gc user view                               # View your profile
oh-gc user view alice                         # View another user's profile
oh-gc user edit --name "New Name" --bio "..."  # Update your profile
oh-gc user edit --avatar "https://..."          # Update avatar
oh-gc user emails                             # List your email addresses
oh-gc user followers                          # List your followers
oh-gc user following                          # List users you follow
oh-gc user events alice                       # List user activity events
oh-gc user events alice --year 2024           # Filter events by year
oh-gc user search alice                       # Search users
oh-gc user search bob --sort joined_at        # Sort by registration time
oh-gc user namespace alice                    # Get namespace by path
oh-gc user namespaces                         # List all your namespaces
oh-gc user namespaces --mode project          # Filter namespace mode
oh-gc user keys                               # List your SSH keys
oh-gc user key-add --title "My Key" --key "ssh-rsa ..."  # Add SSH key
oh-gc user key-delete 123                     # Delete SSH key by ID
oh-gc user starred                            # List your starred repos
oh-gc user starred alice                      # List another user's starred repos
oh-gc user subscriptions                      # List your watched repos
oh-gc user subscriptions alice                # List another user's watched repos
oh-gc user issues                             # List your issues across all repos
oh-gc user issues --state closed --filter created  # Filter user issues
oh-gc user issues --since "2024-01-01T00:00:00Z"  # Issues updated since date
oh-gc user prs                                # List your PRs across all repos
oh-gc user prs --state merged --scope assigned_to_me  # Filter user PRs
oh-gc user prs --source-branch feature --target-branch main  # Filter by branches
oh-gc user orgs alice                         # List user's organizations
oh-gc user membership myorg                   # View your org membership
oh-gc user leave-org myorg                    # Leave an organization

bash

oh-gc user view                               # View your profile
oh-gc user view alice                         # View another user's profile
oh-gc user edit --name "New Name" --bio "..."  # Update your profile
oh-gc user edit --avatar "https://..."          # Update avatar
oh-gc user emails                             # List your email addresses
oh-gc user followers                          # List your followers
oh-gc user following                          # List users you follow
oh-gc user events alice                       # List user activity events
oh-gc user events alice --year 2024           # Filter events by year
oh-gc user search alice                       # Search users
oh-gc user search bob --sort joined_at        # Sort by registration time
oh-gc user namespace alice                    # Get namespace by path
oh-gc user namespaces                         # List all your namespaces
oh-gc user namespaces --mode project          # Filter namespace mode
oh-gc user keys                               # List your SSH keys
oh-gc user key-add --title "My Key" --key "ssh-rsa ..."  # Add SSH key
oh-gc user key-delete 123                     # Delete SSH key by ID
oh-gc user starred                            # List your starred repos
oh-gc user starred alice                      # List another user's starred repos
oh-gc user subscriptions                      # List your watched repos
oh-gc user subscriptions alice                # List another user's watched repos
oh-gc user issues                             # List your issues across all repos
oh-gc user issues --state closed --filter created  # Filter user issues
oh-gc user issues --since "2024-01-01T00:00:00Z"  # Issues updated since date
oh-gc user prs                                # List your PRs across all repos
oh-gc user prs --state merged --scope assigned_to_me  # Filter user PRs
oh-gc user prs --source-branch feature --target-branch main  # Filter by branches
oh-gc user orgs alice                         # List user's organizations
oh-gc user membership myorg                    # View your org membership
oh-gc user leave-org myorg                    # Leave an organization

Branches

分支

bash

oh-gc branch list                             # List all branches
oh-gc branch list --protected                 # List only protected branches
oh-gc branch get <name>                       # Get branch details
oh-gc branch create <name> --ref <sha/branch> # Create a new branch
oh-gc branch delete <name>                    # Delete a branch
oh-gc branch protect <name>                   # Set branch protection rules
oh-gc branch protect <name> --enforce-admins                    # Enforce protection for admins
oh-gc branch protect <name> --require-status-checks ci,lint     # Require status checks
oh-gc branch protect <name> --dismiss-stale-reviews             # Dismiss stale PR reviews
oh-gc branch protect <name> --unprotect       # Remove branch protection
oh-gc branch protect-rules                    # List all branch protection rules
oh-gc branch protect-rule-create <pattern> --pusher <roles> --merger <roles>  # Create protection rule
oh-gc branch protect-rule-update <pattern> --pusher <roles> --merger <roles>  # Update protection rule
oh-gc branch protect-rule-delete <pattern>    # Delete protection rule

bash

oh-gc branch list                             # List all branches
oh-gc branch list --protected                 # List only protected branches
oh-gc branch get <name>                       # Get branch details
oh-gc branch create <name> --ref <sha/branch> # Create a new branch
oh-gc branch delete <name>                    # Delete a branch
oh-gc branch protect <name>                   # Set branch protection rules
oh-gc branch protect <name> --enforce-admins                    # Enforce protection for admins
oh-gc branch protect <name> --require-status-checks ci,lint     # Require status checks
oh-gc branch protect <name> --dismiss-stale-reviews             # Dismiss stale PR reviews
oh-gc branch protect <name> --unprotect       # Remove branch protection
oh-gc branch protect-rules                    # List all branch protection rules
oh-gc branch protect-rule-create <pattern> --pusher <roles> --merger <roles>  # Create protection rule
oh-gc branch protect-rule-update <pattern> --pusher <roles> --merger <roles>  # Update protection rule
oh-gc branch protect-rule-delete <pattern>    # Delete protection rule

Commits

提交

bash

oh-gc commit list                             # List commits
oh-gc commit list --sha main                  # List commits from specific branch
oh-gc commit get <sha>                        # Get commit details
oh-gc commit diff <sha>                       # View commit diff
oh-gc commit compare <base> <head>            # Compare two commits or branches
oh-gc commit comments <sha>                   # List comments on a commit
oh-gc commit comment <sha> --body "text"      # Create a commit comment

bash

oh-gc commit list                             # List commits
oh-gc commit list --sha main                  # List commits from specific branch
oh-gc commit get <sha>                        # Get commit details
oh-gc commit diff <sha>                       # View commit diff
oh-gc commit compare <base> <head>            # Compare two commits or branches
oh-gc commit comments <sha>                   # List comments on a commit
oh-gc commit comment <sha> --body "text"      # Create a commit comment

Files

文件

bash

oh-gc file get <path>                         # Get file contents (base64 encoded)
oh-gc file raw <path> --ref main              # Get raw file contents
oh-gc file list                               # List repository files
oh-gc file create <path> --content "text" --message "msg"  # Create a file
oh-gc file update <path> --sha <sha> --content "text" --message "msg"  # Update a file
oh-gc file delete <path> --sha <sha> --message "msg"       # Delete a file

bash

oh-gc file get <path>                         # Get file contents (base64 encoded)
oh-gc file raw <path> --ref main              # Get raw file contents
oh-gc file list                               # List repository files
oh-gc file create <path> --content "text" --message "msg"  # Create a file
oh-gc file update <path> --sha <sha> --content "text" --message "msg"  # Update a file
oh-gc file delete <path> --sha <sha> --message "msg"       # Delete a file

Collaborators

协作者

bash

oh-gc collaborator list                       # List repository collaborators
oh-gc collaborator add <username>             # Add a collaborator
oh-gc collaborator remove <username>          # Remove a collaborator
oh-gc collaborator permission <username>      # Get collaborator permission level

bash

oh-gc collaborator list                       # List repository collaborators
oh-gc collaborator add <username>             # Add a collaborator
oh-gc collaborator remove <username>          # Remove a collaborator
oh-gc collaborator permission <username>      # Get collaborator permission level

Labels

Milestones

里程碑

bash

oh-gc milestone list                          # List milestones
oh-gc milestone get <number>                  # Get milestone details
oh-gc milestone create                        # Create a new milestone
oh-gc milestone update <number>               # Update a milestone
oh-gc milestone delete <number>               # Delete a milestone

bash

oh-gc milestone list                          # List milestones
oh-gc milestone get <number>                  # Get milestone details
oh-gc milestone create                        # Create a new milestone
oh-gc milestone update <number>               # Update a milestone
oh-gc milestone delete <number>               # Delete a milestone

Webhooks

Webhook

bash

oh-gc hook list                               # List repository webhooks
oh-gc hook get <id>                           # Get webhook details
oh-gc hook create                             # Create a webhook
oh-gc hook delete <id>                        # Delete a webhook

bash

oh-gc hook list                               # List repository webhooks
oh-gc hook get <id>                           # Get webhook details
oh-gc hook create                             # Create a webhook
oh-gc hook delete <id>                        # Delete a webhook

Tag

bash

oh-gc tag list                                # List repository tags
oh-gc tag create <name> --ref <sha/branch>    # Create a tag
oh-gc tag delete <name>                       # Delete a tag
oh-gc tag protect <name>                      # Protect a tag
oh-gc tag protect-get <name>                  # Get protected tag details
oh-gc tag protect-create <name> --access-level 40  # Create protected tag rule
oh-gc tag protect-update <name> --access-level 30  # Update protected tag rule
oh-gc tag protect-delete <name>               # Delete protected tag rule

bash

oh-gc tag list                                # List repository tags
oh-gc tag create <name> --ref <sha/branch>    # Create a tag
oh-gc tag delete <name>                       # Delete a tag
oh-gc tag protect <name>                      # Protect a tag
oh-gc tag protect-get <name>                  # Get protected tag details
oh-gc tag protect-create <name> --access-level 40  # Create protected tag rule
oh-gc tag protect-update <name> --access-level 30  # Update protected tag rule
oh-gc tag protect-delete <name>               # Delete protected tag rule

Organizations

组织

bash

oh-gc org list                                # List your organizations
oh-gc org view <org>                          # Get organization details
oh-gc org members <org>                       # List organization members

bash

oh-gc org list                                # List your organizations
oh-gc org view <org>                          # Get organization details
oh-gc org members <org>                       # List organization members

Workflow: Full PR Lifecycle

工作流：完整的 PR 生命周期

Complete workflow from code change to merged PR:

Step 1: Create PR
  oh-gc pr create --title "Add feature X" --base main
  → outputs PR number (e.g., #42)

Step 2: Assign people
  oh-gc pr reviewers 42 alice,bob
  oh-gc pr testers 42 carol

Step 3: Add metadata
  oh-gc pr labels 42 feature,v2.0
  oh-gc pr link 42 15,16           # Link related issues

Step 4: Review cycle
  oh-gc pr diff 42                 # Reviewer checks diff
  oh-gc pr comments 42             # Check existing feedback
  oh-gc pr comment 42 --body "LGTM"
  oh-gc pr review 42               # Approve review
  oh-gc pr test 42                 # Mark test passed

Step 5: Merge
  oh-gc pr merge 42 --method squash

从代码变更到合并 PR 的完整工作流：

Step 1: Create PR
  oh-gc pr create --title "Add feature X" --base main
  → outputs PR number (e.g., #42)

Step 2: Assign people
  oh-gc pr reviewers 42 alice,bob
  oh-gc pr testers 42 carol

Step 3: Add metadata
  oh-gc pr labels 42 feature,v2.0
  oh-gc pr link 42 15,16           # Link related issues

Step 4: Review cycle
  oh-gc pr diff 42                 # Reviewer checks diff
  oh-gc pr comments 42             # Check existing feedback
  oh-gc pr comment 42 --body "LGTM"
  oh-gc pr review 42               # Approve review
  oh-gc pr test 42                 # Mark test passed

Step 5: Merge
  oh-gc pr merge 42 --method squash

Workflow: Issue Triage

工作流：Issue 分诊

Step 1: Find issues
  oh-gc issue list --search "crash"
  oh-gc issue list --state all --assignee alice

Step 2: Inspect
  oh-gc issue view 15

Step 3: Respond
  oh-gc issue comment 15 --body "Investigating, likely related to #12"

Step 4: Create follow-up
  oh-gc issue create --title "Fix crash on login" --labels "bug,P0" --assignee bob

Step 1: Find issues
  oh-gc issue list --search "crash"
  oh-gc issue list --state all --assignee alice

Step 2: Inspect
  oh-gc issue view 15

Step 3: Respond
  oh-gc issue comment 15 --body "Investigating, likely related to #12"

Step 4: Create follow-up
  oh-gc issue create --title "Fix crash on login" --labels "bug,P0" --assignee bob

Workflow: Cross-Repo PR (Fork → Upstream)

工作流：跨仓库 PR（Fork → Upstream）

For contributing to repositories you don't own, use

--head owner:branch

format to specify the fork owner and branch:

Step 1: Create PR from fork to upstream
  oh-gc pr create --repo upstream-owner/repo --head myname:my-feature --base master --title "Fix bug"

Step 2: Manage on the upstream repo
  oh-gc pr view 42 --json    # Check status

Note:

--repo

targets the upstream repo.

--head

uses

owner:branch

format (colon separator) where

owner

is your GitCode username and

branch

is the branch name in your fork. Do NOT use

owner/branch

(slash) — the API requires a colon.

对于向不归你所有的仓库贡献代码，请使用

--head owner:branch

格式指定 Fork 所有者及其分支：

Step 1: Create PR from fork to upstream
  oh-gc pr create --repo upstream-owner/repo --head myname:my-feature --base master --title "Fix bug"

Step 2: Manage on the upstream repo
  oh-gc pr view 42 --json    # Check status

注意：对于跨仓库 PR，

--repo

指向 upstream 仓库。

--head

使用

owner:branch

格式（冒号分隔），其中

owner

是你的 GitCode 用户名，

branch

是 Fork 中的分支名称。不要使用

owner/branch

（斜杠分隔）——API 要求使用冒号。

Configuration

配置

Setting	Location	How to set
Auth token	`~/.config/gitcode-cli/config.json`	`oh-gc auth login`
Remote override	`.gitcode/oh-gc-config.json`	`oh-gc repo set-remote <name>`
Proxy	`https_proxy` / `HTTPS_PROXY` env var	Automatic

设置	位置	设置方式
身份验证 Token	`~/.config/gitcode-cli/config.json`	`oh-gc auth login`
Remote 覆盖配置	`.gitcode/oh-gc-config.json`	`oh-gc repo set-remote <name>`
代理	`https_proxy` / `HTTPS_PROXY` 环境变量	自动

Decision Tree

决策树

User wants to interact with GitCode
  ↓
Version matches? (oh-gc --version)
  ↓ No → npm install -g @oh-gc/cli@{version}
  ↓ Yes
Logged in? (oh-gc auth status)
  ↓ No → oh-gc auth login
  ↓ Yes
Inside git repo with gitcode.com remote?
  ↓ No → Use --repo flag, or cd to repo
  ↓ Yes
What does user want?
  ├─ List/view issues      → oh-gc issue list / issue view
  ├─ Create issue           → oh-gc issue create
  ├─ Update issue           → oh-gc issue update
  ├─ Close/reopen issue     → oh-gc issue close / issue reopen
  ├─ Comment on issue       → oh-gc issue comment
  ├─ Manage issue labels    → oh-gc issue labels
  ├─ View issue history     → oh-gc issue history
  ├─ View issue reactions   → oh-gc issue reactions
  ├─ List/view PRs          → oh-gc pr list / pr view
  ├─ Create PR              → oh-gc pr create
  ├─ Update PR              → oh-gc pr update
  ├─ Close/reopen PR        → oh-gc pr close / pr reopen
  ├─ View PR reactions      → oh-gc pr reactions
  ├─ Review PR diff         → oh-gc pr diff
  ├─ Comment on PR          → oh-gc pr comment (general) or --path --line (line-level)
  ├─ Assign reviewers       → oh-gc pr reviewers
  ├─ Assign testers         → oh-gc pr testers
  ├─ Approve review         → oh-gc pr review
  ├─ Mark test passed       → oh-gc pr test
  ├─ Manage labels          → oh-gc pr labels
  ├─ Link issues to PR      → oh-gc pr link
  ├─ Merge PR               → oh-gc pr merge
  ├─ View PR history        → oh-gc pr logs
  ├─ Create release         → oh-gc release create
  ├─ Search repos/issues    → oh-gc search repos / search issues / search code
  ├─ View user profile      → oh-gc user view
  ├─ Edit user profile      → oh-gc user edit
  ├─ List user events       → oh-gc user events
  ├─ Search users           → oh-gc user search
  ├─ Manage SSH keys        → oh-gc user keys / user key-add / user key-delete
  ├─ View starred repos     → oh-gc user starred
  ├─ View watched repos     → oh-gc user subscriptions
  ├─ View namespaces        → oh-gc user namespace / user namespaces
  ├─ Manage branches        → oh-gc branch list / branch get / branch protect
  ├─ View commits/files     → oh-gc commit list / file get
  ├─ Manage collaborators   → oh-gc collaborator list / add / remove
  ├─ Manage labels          → oh-gc label list / create / update / delete
  ├─ Manage milestones      → oh-gc milestone list / create / update
  ├─ Manage webhooks        → oh-gc hook list / create / delete
  └─ Configure remote       → oh-gc repo set-remote / repo get-remote

User wants to interact with GitCode
  ↓
Version matches? (oh-gc --version)
  ↓ No → npm install -g @oh-gc/cli@{version}
  ↓ Yes
Logged in? (oh-gc auth status)
  ↓ No → oh-gc auth login
  ↓ Yes
Inside git repo with gitcode.com remote?
  ↓ No → Use --repo flag, or cd to repo
  ↓ Yes
What does user want?
  ├─ List/view issues      → oh-gc issue list / issue view
  ├─ Create issue           → oh-gc issue create
  ├─ Update issue           → oh-gc issue update
  ├─ Close/reopen issue     → oh-gc issue close / issue reopen
  ├─ Comment on issue       → oh-gc issue comment
  ├─ Manage issue labels    → oh-gc issue labels
  ├─ View issue history     → oh-gc issue history
  ├─ View issue reactions   → oh-gc issue reactions
  ├─ List/view PRs          → oh-gc pr list / pr view
  ├─ Create PR              → oh-gc pr create
  ├─ Update PR              → oh-gc pr update
  ├─ Close/reopen PR        → oh-gc pr close / pr reopen
  ├─ View PR reactions      → oh-gc pr reactions
  ├─ Review PR diff         → oh-gc pr diff
  ├─ Comment on PR          → oh-gc pr comment (general) or --path --line (line-level)
  ├─ Assign reviewers       → oh-gc pr reviewers
  ├─ Assign testers         → oh-gc pr testers
  ├─ Approve review         → oh-gc pr review
  ├─ Mark test passed       → oh-gc pr test
  ├─ Manage labels          → oh-gc pr labels
  ├─ Link issues to PR      → oh-gc pr link
  ├─ Merge PR               → oh-gc pr merge
  ├─ View PR history        → oh-gc pr logs
  ├─ Create release         → oh-gc release create
  ├─ Search repos/issues    → oh-gc search repos / search issues / search code
  ├─ View user profile      → oh-gc user view
  ├─ Edit user profile      → oh-gc user edit
  ├─ List user events       → oh-gc user events
  ├─ Search users           → oh-gc user search
  ├─ Manage SSH keys        → oh-gc user keys / user key-add / user key-delete
  ├─ View starred repos     → oh-gc user starred
  ├─ View watched repos     → oh-gc user subscriptions
  ├─ View namespaces        → oh-gc user namespace / user namespaces
  ├─ Manage branches        → oh-gc branch list / branch get / branch protect
  ├─ View commits/files     → oh-gc commit list / file get
  ├─ Manage collaborators   → oh-gc collaborator list / add / remove
  ├─ Manage labels          → oh-gc label list / create / update / delete
  ├─ Manage milestones      → oh-gc milestone list / create / update
  ├─ Manage webhooks        → oh-gc hook list / create / delete
  └─ Configure remote       → oh-gc repo set-remote / repo get-remote

Error Handling

错误处理

Error	Cause	Fix
"Not logged in"	No token configured	`oh-gc auth login`
"Authentication failed"	Token expired or invalid	Re-run `oh-gc auth login` with new token
"Remote not found"	Not in a git repo or remote missing	`cd` to repo, check `git remote -v`
"Not a GitCode repository"	Remote URL isn't `gitcode.com`	Add a gitcode.com remote
"Could not connect"	Network issue or proxy not set	Check internet; set `https_proxy` env var if behind proxy
"Rate limit exceeded"	Too many API calls	Wait and retry
"API error 405"	Wrong HTTP method (internal)	Update oh-gc to latest version
"Can not find the branch"	`--head` missing fork owner prefix	Use `--head owner:branch` (colon, not slash) for cross-repo PRs

错误	原因	修复方法
"Not logged in"	未配置 Token	`oh-gc auth login`
"Authentication failed"	Token 已过期或无效	使用新的 Token 重新运行 `oh-gc auth login`
"Remote not found"	当前不在 git 仓库中，或缺少 remote	`cd` 到仓库，检查 `git remote -v`
"Not a GitCode repository"	Remote URL 不是 `gitcode.com`	添加一个 gitcode.com remote
"Could not connect"	网络问题或未设置代理	检查网络；如果处于代理之后，请设置 `https_proxy` 环境变量
"Rate limit exceeded"	API 调用次数过多	等待后重试
"API error 405"	HTTP 方法错误（内部问题）	将 oh-gc 更新至最新版本
"Can not find the branch"	`--head` 缺少 Fork owner 前缀	跨仓库 PR 使用 `--head owner:branch` （使用冒号，而不是斜杠）

URL Format

URL 格式

When constructing GitCode URLs for issues and PRs, use the singular form for PRs:

Issue:

https://gitcode.com/{owner}/{repo}/issues/{number}

(plural: issues)

PR:

https://gitcode.com/{owner}/{repo}/pull/{number}

(singular: pull, NOT pulls)

Common mistake: Using

/pulls/

(GitHub style) instead of

/pull/

. GitCode uses singular

pull

, not

pulls

.

构建 GitCode Issue 和 PR 的 URL 时，请注意 PR 使用单数形式：

Issue：

https://gitcode.com/{owner}/{repo}/issues/{number}

（复数：issues）

PR：

https://gitcode.com/{owner}/{repo}/pull/{number}

（单数：pull，而不是 pulls）

常见错误： 使用

/pulls/

（GitHub 风格）而不是

/pull/

。GitCode 使用单数

pull

，而不是

pulls

。

Tips

提示

Use

--json

to pipe output to

jq

for scripting:

oh-gc pr list --json | jq '.[].title'

Use
```
--repo owner/repo
```
to operate on any repository without cloning it first
Interactive mode (no flags) prompts for required fields — useful for one-off operations

oh-gc pr comments --comment-type diff_comment

filters to only code review comments

```
oh-gc pr reviewers --append
```
adds reviewers without replacing existing ones
```
oh-gc pr update --state closed
```
is the way to close a PR without merging
When reporting PR links to the user, always use
```
https://gitcode.com/{owner}/{repo}/pull/{number}
```
(singular
```
pull
```
)

使用
```
--json
```
将输出通过管道传递给
```
jq
```
以编写脚本：
```
oh-gc pr list --json | jq '.[].title'
```
使用
```
--repo owner/repo
```
，无需事先克隆仓库即可操作任意仓库
交互模式（不使用参数）会提示输入所需字段——适合一次性操作

oh-gc pr comments --comment-type diff_comment

仅筛选代码评审评论

```
oh-gc pr reviewers --append
```
在不替换现有 Reviewer 的情况下添加 Reviewer
```
oh-gc pr update --state closed
```
是在不合并的情况下关闭 PR 的方式
向用户报告 PR 链接时，始终使用
```
https://gitcode.com/{owner}/{repo}/pull/{number}
```
（单数
```
pull
```
）

gitcode-cli

Original

Translation

oh-gc CLI — GitCode Command Line Tool

oh-gc CLI — GitCode 命令行工具

⚠️ MANDATORY FIRST STEP — DO NOT SKIP

⚠️ 强制第一步 — 不得跳过

Prerequisites

前置条件

Global Flags

全局参数

Repository Flag

仓库参数

List issues in any repository

List issues in any repository

Create an issue without cloning

Create an issue without cloning

View a PR on another repo

View a PR on another repo

Cross-repo PR (fork to upstream) — use owner:branch for --head

Cross-repo PR (fork to upstream) — use owner:branch for --head

Command Reference

命令参考

Authentication

身份验证

Issues

Issue

List

List

View

View

Create

Create

Comment

Comment

Close/Reopen

Close/Reopen

Labels

Labels

History

History

Reactions

Reactions

Linked PRs

Linked PRs

Related branches

Related branches

Comment management

Comment management

Pull Requests

Pull Request

List

List

View

View

Create

Create

Update

Update

Close/Reopen

Close/Reopen

Diff

Diff

Merge

Merge

Comment

Comment

List/delete comments

List/delete comments

Reactions

Reactions

Commits

Commits

Reviewers

Reviewers

Testers

Testers

Review & Test approval

Review & Test approval

Labels