ghx

ghx Skill

ghx is an extended GitHub CLI. It talks to the GitHub GraphQL API directly to provide two kinds of capability:

1. Cached browsing — fetches issues, pull requests, and their comments and caches every result to ~/.cache/ghx/cache/<host>/<owner>/<repo> to minimise API calls.
2. Comment operations — inline review comments, line-range comments, thread replies, pending reviews, and a local "stash" for offline review comments, none of which the standard gh CLI supports.

---

Prerequisites

Binary

Check whether the binary is on PATH; install from the latest release if not:

if ! command -v ghx &>/dev/null; then
  go install github.com/tomzxcode/ghx@main
fi

Pre-built binaries are also available at https://github.com/TomzxCode/ghx/releases/tag/latest.

Authentication

ghx reads GH_TOKEN or GITHUB_TOKEN from the environment, and falls back to gh auth token (GitHub CLI). Set the token if neither is available:

export GH_TOKEN=<token>

Target repository

All commands accept --repo [HOST/]OWNER/REPO (or -R). When omitted, the repo is auto-detected from the origin remote of the current directory. Confirm the target before running expensive or write operations:

git remote get-url origin

---

Cached browsing

Pre-populate the cache

Run cache once to pull everything down so subsequent list/view commands are served instantly from disk:

ghx cache                            # default: stale after 60 min
ghx cache --repo owner/repo
ghx cache --cache-duration 120       # stale after 2 hours
ghx cache --cache-duration 0         # always re-fetch (delta)
ghx cache --force                    # force full re-fetch

List issues

ghx issue list                       # open issues (default)
ghx issue list --state all
ghx issue list --author alice
ghx issue list --assignee bob
ghx issue list --label bug
ghx issue list --label bug --label p1   # AND logic
ghx issue list --milestone v2.0
ghx issue list --search "memory leak"
ghx issue list --limit 50
ghx issue list --json                # machine-readable output