gh-checkproxy
4
总安装量
4
周安装量
#49323
全站排名
安装命令
npx skills add https://github.com/bycli/gh-checkproxy --skill gh-checkproxy
Agent 安装分布
amp
4
gemini-cli
4
github-copilot
4
codex
4
kimi-cli
4
cursor
4
Skill 文档
gh-checkproxy
Use gh-checkproxy only for checks/status visibility that fine-grained tokens cannot read directly. Keep all other repository actions in regular gh CLI flow.
Client usage (primary)
Environment variables
GH_CHECKPROXY_URLâ proxy base URL (e.g.http://localhost:8080)GH_TOKENâ fine-grained PAT with Metadata: read on the target repo
Set via export, .env, shell profile, or CI secrets.
Commands
gh-checkproxy pr checks <PR> --repo <owner>/<repo> # snapshot
gh-checkproxy pr checks <PR> --repo <owner>/<repo> --watch # block until done
gh-checkproxy pr checks <PR> --repo <owner>/<repo> --watch --fail-fast # exit on first failure
gh-checkproxy pr checks # auto-detect from git
Exit codes
| Code | Meaning |
|---|---|
0 |
All checks passed |
1 |
One or more failed |
8 |
Still pending |
Workflow
gh-checkproxy pr checks $PR --repo myorg/myrepo --watch
# exit 0 â proceed | exit 1 â investigate | exit 8 â still pending
gh pr view $PR --repo myorg/myrepo # continue with normal gh
Re-run --watch when the user asks to recheck CI.
Client setup
Quick verification: gh-checkproxy pr checks 1 --repo owner/repo. Connection error â wrong URL or server down. 403 â GH_TOKEN missing or lacks Metadata: read.
Server setup (secondary)
For deploying the proxy on a trusted host (one-time or occasional setup):
1. Configure
gh-checkproxy config
Interactive prompts: classic PAT (repo scope), optional org restriction, port (default 8080), cache TTL (default 5m). Or use flags:
gh-checkproxy config --classic-token ghp_xxx --org myorg --port 8080
Config: ~/.config/gh-checkproxy/config.json
2. Start the server
gh-checkproxy serve
Run on localhost or behind a TLS-terminating reverse proxy for production.
3. Check status
gh-checkproxy status