pygitcode

A CLI tool for GitCode (api.gitcode.com), modeled after GitHub CLI (gh).

English | 中文

For agent-assisted setup, usage, upgrades, or troubleshooting, read docs/en/USING_WITH_AGENT.md first.

Installation

pip install pygitcode

This exposes both gc and gitcode commands in your shell.

To optionally route existing gh commands between GitCode and GitHub, install and configure the managed proxy:

gc setup gh-proxy --configure

The command installs the shim, adds a managed shell PATH block, and registers OpenCode instructions that teach agents to try the dispatcher before API fallbacks. Restart OpenCode afterward. The proxy sends GitCode repositories to gc, sends GitHub or unknown contexts to the native gh, and refuses unsupported commands when the target is GitCode. See the compatibility notes for routing controls and uninstall instructions.

Quick Start

If you already know GitHub CLI (gh), you can start with the same familiar flows:

gc auth login
gc issue list
gc issue view 42
gc pr list
gc pr create --fill
gc pr audit
gc pr merge 42 --squash

Use gitcode instead of gc on Windows PowerShell because gc is a built-in alias for Get-Content.

gc pr audit prints a reason for every failed R1-R4 merge-readiness rule. List-mode errors other than HTTP 401 are recorded per PR and exit 0 unless --fail-exit is set. HTTP 401 aborts the remaining list and exits 1, regardless of this flag.

Documentation

• Documentation index
• Development guide
• Compatibility notes

Repository Selection

Commands operate on the current Git repository by default. You can also select a repository explicitly:

gc issue list -R owner/repo
gc pr list -R owner/repo

Authentication

gc resolves tokens in this order:

1. --token option
2. GC_TOKEN environment variable
3. ~/.config/gc/config.json, written by gc auth login

Useful commands:

gc auth login
gc auth status
gc auth token
gc auth logout

License

MIT