GitHub CLI for agents — designed with AXI (Agent eXperience Interface).

Wraps the official gh cli with token-efficient TOON output, contextual next-step suggestions, and structured error handling. Built for autonomous agents that interact with GitHub via shell execution.

Install

npm install -g gh-axi

Requires Node 20+ and gh authenticated via gh auth login.

Running gh-axi also installs or repairs Claude Code and Codex SessionStart hooks. Those hooks invoke gh-axi directly from the packaged production build.

Usage

gh-axi                          # dashboard - live state, no args needed
gh-axi issue list               # list issues in current repo
gh-axi issue subissue list 16   # list sub-issues for issue #16
gh-axi pr view 42               # view pull request #42
gh-axi run list -R owner/repo   # list workflow runs for a specific repo
gh-axi run view 123456 --job 789012       # inspect a single job within a run
gh-axi run view --job 789012 --log-failed # show failed log lines for one job

Commands

| Command | Description | | ---------- | ------------------------------------------------------------------- | | issue | Issues — list, view, create, edit, close, reopen, comment, subissue | | pr | Pull requests — list, view, create, merge, review, checks | | run | Workflow runs — list, view, rerun, cancel, watch | | workflow | Workflows — list, view, run, enable, disable | | release | Releases — list, view, create, edit, delete | | repo | Repositories — list, view, create, edit, clone, fork | | label | Labels — list, create, edit, delete | | search | Search issues, PRs, repos, commits, code | | api | Raw GitHub API access |

Global flags

• --help — show help for any command
• -v, -V, --version — show the installed gh-axi version

Repository targeting is command-first too:

• gh-axi issue list -R owner/name
• gh-axi issue list --repo owner/name
• gh-axi run list -R owner/name
• gh-axi search issues "login bug" --repo owner/name

When a command also needs a destination repository, use a dedicated flag for it:

• gh-axi issue transfer 42 -R source/repo --to-repo dest/repo

License

MIT