gitcode-cli

CLI for the GitCode REST API — manage repos, PRs, issues, commits, and more from the terminal.

Install

npm install -g @tonyclaw/gitcode-cli

Setup

# Store token in config file
gitcode config set token <your-gitcode-token>

# Or use environment variable
export GITCODE_TOKEN=<your-token>

Get a personal access token from GitCode Settings.

Usage

# Repositories
gitcode repos list <username>
gitcode repos get <owner> <repo>
gitcode repos tree <owner> <repo> <branch>
gitcode repos languages <owner> <repo>
gitcode repos contributors <owner> <repo>

# Pull Requests
gitcode pr list <owner> <repo>
gitcode pr get <owner> <repo> <number>
gitcode pr create <owner> <repo> --title "fix" --head feat --base main

# Issues
gitcode issue list <owner> <repo>
gitcode issue create <owner> <repo> --title "bug" --body "..."
gitcode issue update <owner> <repo> <number> --state closed

# Commits
gitcode commit list <owner> <repo>
gitcode commit get <owner> <repo> <sha>
gitcode commit compare <owner> <repo> --base main --head dev

# Search
gitcode search repos <query>
gitcode search users <query>

# Branches & Tags
gitcode branch list <owner> <repo>
gitcode tag list <owner> <repo>

# More topics
gitcode milestone list <owner> <repo>
gitcode label list <owner> <repo>
gitcode release list <owner> <repo>
gitcode webhook list <owner> <repo>
gitcode member list <owner> <repo>
gitcode user profile [username]
gitcode org list <username>
gitcode enterprise members <name>
gitcode actions runs <owner> <repo>

All commands output JSON. Use gitcode --help to see all available topics.

All Topics

| Topic | Commands | |-------|----------| | actions | runs | | branch | list, get, create, delete | | commit | list, get, compare, diff | | config | get, set | | enterprise | members, repos | | issue | list, get, create, update, comments | | label | list, create, delete | | member | list, add, remove | | milestone | list, get, create, update | | org | list, members, repos | | pr | list, get, create, merge, files, comments | | release | list, get, create, delete | | repos | list, get, tree, languages, contributors, forks, stargazers, raw, file-list | | search | repos, users, issues, code | | tag | list, create, delete | | user | profile, starred, following | | webhook | list, create, delete |

Output Formats

List commands support --format for different output styles:

gitcode pr list claw/repo --format table    # ASCII table
gitcode pr list claw/repo --format compact  # Single-line JSON
gitcode pr list claw/repo --format json     # Pretty-printed JSON (default)

Dry Run

Set GITCODE_DRY_RUN=true to preview API requests without executing:

GITCODE_DRY_RUN=true gitcode pr list claw/repo
# [dry-run] GET https://api.gitcode.com/api/v5/repos/claw/repo/pulls

Shell Completion

Bash

gitcode autocomplete script bash >> ~/.bashrc
source ~/.bashrc

Zsh

gitcode autocomplete script zsh >> ~/.zshrc
source ~/.zshrc

PowerShell

gitcode autocomplete script powershell | Out-String | Invoke-Expression

Dynamic Suggestions

For API-driven completion (owner names, repo names, branches), the gitcode complete command is available for shell completion scripts:

gitcode complete owner              # → TonyClaw (your login + orgs)
gitcode complete repo <owner>       # → repo1, repo2, ...
gitcode complete branch <owner> <repo>  # → main, dev, ...

License

MIT © 2026 TonyClaw