gitcode-cli について
gitcode-cliは、GitCodeのユーザーがターミナルからリポジトリの作業や設定を管理するコマンドラインツールです。--repoでローカルにクローンしていないリポジトリも指定でき、スクリプト向けにJSONを出力します。
主な機能
- 01認証とプロフィールの管理
- 02イシューとプルリクエストの操作
- 03リリース、ブランチ、コミットの管理
- 04ファイル、ラベル、Webhookの操作
- 05リポジトリ、イシュー、コードの検索
- 06--repoとJSON出力に対応
活用シーン
- 01ターミナルでイシューを絞り込み、追跡
- 02フォークから上流リポジトリへプルリクエストを作成
- 03複数リポジトリ向けCI/CDスクリプトの作成
- 04リポジトリのファイル、ブランチ保護、リリースの更新
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/gitcode-cliを入力して読み込まれたか確認します。
同梱ファイルgitcode-pr-workflow.md
詳細
oh-gc CLI — GitCode コマンドラインツール
バージョン： 0.7.4 | 更新日： 2026-04-10
oh-gc は、GitHub CLI（gh）をモデルにした、GitCode 用の CLI です。ターミナルから認証、イシュー、プルリクエスト、リリース、リポジトリ設定を管理できます。
パッケージ： npm install -g @oh-gc/cli（Node.js 18+ が必要です）
⚠️ 必須の最初の手順 — 省略しないでください
ほかの 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、その他のコマンドを実行しないでください。
前提条件
バージョンが一致していることを確認した後、以下を確認してください。
- トークンは設定されていますか？
oh-gc auth statusを実行します- ログインしていない場合 →
oh-gc auth login（GitCode の個人アクセストークンの入力を求められます） - トークンの取得先：GitCode → 个人设置 → 访问令牌
- ログインしていない場合 →
- リポジトリのコンテキストはありますか？ 以下のいずれかを満たしてください。
gitcode.comのリモートを設定した git リポジトリ内にいる（リモート名はoh-gc repo set-remote <name>で設定可能）、または--repo owner/repoフラグを使用して、任意のリポジトリを指定する
グローバルフラグ
すべてのコマンドで以下を使用できます。
--json— 書式付きテーブルの代わりに、生の JSON を出力します--help— コマンドのヘルプを表示します
リポジトリフラグ
リポジトリを操作するほとんどのコマンドでは、--repo フラグを使用できます。これにより、git クローン内にいなくても対象のリポジトリを指定できます。
--repo owner/repo— OWNER/REPO 形式で対象のリポジトリを指定します
次のような場合に便利です。
- ローカルにクローンしていないリポジトリを操作する
- リポジトリ間の操作（例：フォークから上流リポジトリへの PR 作成）
- 複数のリポジトリとやり取りする CI/CD スクリプト
# 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
コマンドリファレンス
認証
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
トークンは ~/.config/gitcode-cli/config.json に保存されます。
イシュー
# 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
プルリクエスト
# 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
リリース
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
リポジトリ設定
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
リモートの上書き設定は、リポジトリのルートにある .gitcode/oh-gc-config.json に保存されます。
検索
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
ユーザー
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
ブランチ
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
コミット
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
ファイル
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
コラボレーター
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
ラベル
oh-gc label list # List repository labels
oh-gc label create # Create a new label
oh-gc label update <name> # Update a label
oh-gc label delete <name> # Delete a label
マイルストーン
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
Webhook
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
タグ
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
組織
oh-gc org list # List your organizations
oh-gc org view <org> # Get organization details
oh-gc org members <org> # List organization members
ワークフロー：PR の全ライフサイクル
コード変更から 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
ワークフロー：イシューのトリアージ
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
ワークフロー：リポジトリ間の PR（フォーク → 上流リポジトリ）
自分が所有していないリポジトリに貢献する場合は、--head owner: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
注：--repo は上流リポジトリを指定します。--head は owner:branch 形式（コロン区切り）を使用します。owner は GitCode のユーザー名、branch はフォーク内のブランチ名です。owner/branch（スラッシュ）は使用しないでください。API ではコロンが必要です。
設定
| 設定 | 保存場所 | 設定方法 |
|---|---|---|
| 認証トークン | ~/.config/gitcode-cli/config.json | oh-gc auth login |
| リモートの上書き設定 | .gitcode/oh-gc-config.json | oh-gc repo set-remote <name> |
| プロキシ | https_proxy / HTTPS_PROXY 環境変数 | 自動 |
判断ツリー
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
エラー処理
| エラー | 原因 | 対処方法 |
|---|---|---|
| "ログインしていません" | トークンが設定されていません | oh-gc auth login |
| "認証に失敗しました" | トークンの有効期限が切れているか、無効です | 新しいトークンで oh-gc auth login を再実行します |
| "リモートが見つかりません" | Git リポジトリではないか、リモートがありません | リポジトリに cd し、git remote -v を確認します |
| "GitCode リポジトリではありません" | リモート URL が gitcode.com ではありません | gitcode.com のリモートを追加します |
| "接続できませんでした" | ネットワークに問題があるか、プロキシが設定されていません | インターネット接続を確認します。プロキシ経由の場合は https_proxy 環境変数を設定します |
| "レート制限を超過しました" | API 呼び出しが多すぎます | 時間をおいて再試行します |
| "API エラー 405" | HTTP メソッドが間違っています（内部エラー） | oh-gc を最新バージョンに更新します |
| "ブランチが見つかりません" | --head にフォーク元のオーナーのプレフィックスがありません | リポジトリ間の PR では --head owner:branch（スラッシュではなくコロン）を使用します |
URL 形式
Issue と PR の GitCode URL を作成する際は、PR には単数形を使用します。
- Issue：
https://gitcode.com/{owner}/{repo}/issues/{number}（複数形：issues） - PR：
https://gitcode.com/{owner}/{repo}/pull/{number}（単数形：pull、pulls ではありません）
よくある間違い： /pull/ ではなく、GitHub 形式の /pulls/ を使用すること。GitCode では pulls ではなく、単数形の pull を使用します。
ヒント
- スクリプトで出力を
jqに渡すには--jsonを使用します：oh-gc pr list --json | jq '.[].title' - リポジトリを事前にクローンせずに任意のリポジトリを操作するには
--repo owner/repoを使用します - 対話モード（フラグなし）では必須項目の入力を求められるため、単発の操作に便利です
oh-gc pr comments --comment-type diff_commentはコードレビューのコメントのみを絞り込みますoh-gc pr reviewers --appendは既存のレビュアーを置き換えずに追加しますoh-gc pr update --state closedはマージせずに PR をクローズする方法です- PR のリンクをユーザーに伝える際は、必ず
https://gitcode.com/{owner}/{repo}/pull/{number}（単数形のpull）を使用します
コメント
Markdown 対応