| name | gh-cli |
| description | Monitor and operate GitHub Actions for the proxysss repository with the GitHub CLI. Use when checking CI/release workflow status, reading failed job logs, rerunning workflows, inspecting release assets, or when the user asks to watch GitHub Actions with gh. |
GitHub CLI Actions Monitor
Prerequisites
- Confirm
gh is installed: gh --version
- Confirm auth:
gh auth status
- If not authenticated, stop and ask the user to run
gh auth login (repo + workflow scopes).
Default repository: neko233-com/proxysss
Quick Status
gh repo view neko233-com/proxysss --json name,defaultBranchRef
gh workflow list -R neko233-com/proxysss
gh run list -R neko233-com/proxysss --limit 10
gh release list -R neko233-com/proxysss --limit 5
Workflow Map
| Workflow | File | Purpose |
|---|
ci | .github/workflows/ci.yml | actionlint, rustfmt, clippy, tests, multi-OS build |
deploy | .github/workflows/deploy.yml | package bundles |
release | .github/workflows/release.yml | tag builds + GitHub Release assets |
Investigate Failures
gh run list -R neko233-com/proxysss --status failure --limit 5
gh run view <run-id> -R neko233-com/proxysss
gh run view <run-id> -R neko233-com/proxysss --log-failed
gh run watch <run-id> -R neko233-com/proxysss --exit-status
Filter by workflow:
gh run list -R neko233-com/proxysss --workflow=ci.yml --limit 5
gh run list -R neko233-com/proxysss --workflow=release.yml --limit 5
Release Monitoring
After pushing a v* tag:
gh run list -R neko233-com/proxysss --workflow=release.yml --limit 3
gh release view vX.Y.Z -R neko233-com/proxysss
Verify all six assets exist:
proxysss-windows-amd64.zip
proxysss-windows-arm64.zip
proxysss-linux-amd64.tar.gz
proxysss-linux-arm64.tar.gz
proxysss-darwin-amd64.tar.gz
proxysss-darwin-arm64.tar.gz
If publish fails on Extract current changelog, the tagged commit is missing ## vX.Y.Z in CHANGELOG.md. Fix the changelog on main, bump version if needed, commit, then push a new tag on that commit (do not rely on rerunning an old tag).
Release Checklist (agents)
- Bump
Cargo.toml version and add ## vX.Y.Z - YYYY-MM-DD to CHANGELOG.md.
- Push to
main and wait for green ci (gh run watch on the latest CI run).
- Tag and push:
git tag vX.Y.Z && git push origin vX.Y.Z.
- Watch release:
gh run list -R neko233-com/proxysss --workflow=release.yml --limit 1 then gh run watch <id> --exit-status.
- Confirm assets:
gh release view vX.Y.Z -R neko233-com/proxysss.
Workflows use upload-artifact@v6 / download-artifact@v6 (Node.js 24 LTS). Do not downgrade to v4.
Rerun And Repair
gh run rerun <run-id> -R neko233-com/proxysss --failed
gh workflow run release.yml -R neko233-com/proxysss --ref main
Agent Handoff Format
When reporting Actions status to the user, include:
- Workflow name and run URL
- Conclusion (
success, failure, in_progress)
- Failed job names (from
gh run view)
- One-line root cause from
--log-failed
- Next fix or rerun command
Related Skills
.github/skills/github-actions/SKILL.md — edit and validate workflow YAML locally
skills/proxysss-install/SKILL.md — install released binaries after a green release run