← Artifacts & connectors

github

GitHub

Official CLI · gh

Reads
comments, reactions, merge state, review state, stars, forks, release asset downloads.
Locators
PR/issue/release URL, `owner/repo#123`, or a release tag.
Evidence for a linked target
`gh` / GitHub API result, GitHub URL, merge or release metadata.
Official docs
https://cli.github.com/manual/

Usage

Agent command: superdense reward docs connectors --connector github

# github — usage

Use the official `gh` CLI to read engagement on PRs, issues, and releases.

```bash
# PR state, reviews, and reactions
gh pr view <number> --json state,reviewDecision,comments,reactionGroups
# Release asset download counts
gh release view <tag> --json assets,reactionGroups
# Repo-level stars/forks
gh repo view <owner/repo> --json stargazerCount,forkCount
```

**Reward dimensions:** comments, reactions, merge state, stars, forks, release downloads.
**Locators:** PR/issue/release URL, `owner/repo#123`, release tag.

Install

Agent command: superdense reward docs connectors --connector github --section install

Install the official **gh** CLI and authenticate it for the account that owns the artifact.

Use the vendor's official installation guide rather than a copy here, so steps stay current:

- https://cli.github.com/manual/installation

Once installed and authenticated, the `usage` section shows how to read metrics.

Troubleshoot

Agent command: superdense reward docs connectors --connector github --section troubleshoot

If a `gh` call fails, the fastest fix is usually re-auth or a version bump.

Check, in order:

1. **Auth** — confirm you are logged in to the right account/scope.
2. **Version** — update gh to the latest release.
3. **Permissions** — confirm the account can see the resource.

For anything deeper, use the official troubleshooting docs:

- https://cli.github.com/manual/