Skip to main content

GitHub CLI operations

v0.1.9

GitHub introspection — PRs, issues, repos, workflow runs, releases, commit checks, search — plus operator actions: merge PR, close PR, rerun workflow, dispatch workflow. Authenticates via the runner host's `gh auth status` token (i.e. ~/.config/gh).

17 allowed by default 2 need approval by default
Pack ID
github-cli
Vendor
emisar
OS
linux
Actions
19
Required binaries. Install these on the host before relying on the pack — an action that calls a missing one fails at run time.
gh

Install

emisar pack install fetches this pack, re-validates it, and verifies its content hash against the --hash below — the exact bytes this page was rendered against, so a tampered copy is rejected — before copying it into the runner's packs dir. The command reloads a running daemon itself; no manual restart.

on the runner host
sudo emisar pack install github-cli --hash sha256:35ca71f482e08b84a5e59fe3988bbf30f931260a98228a105bed3f6b5ca8048f

Actions 19 total

View on GitHub
  • gh.auth_status exec low

    gh auth status

    Show which GitHub account the runner's `gh` is signed in as + token scopes.

    View source on GitHub
  • gh.branch_list exec low

    gh api repos/<repo>/branches

    List branches in the repo (paginated, up to 100).

    View source on GitHub
  • gh.issue_list exec low

    gh issue list

    List open issues for one repo.

    View source on GitHub
  • gh.issue_view exec low

    gh issue view

    Show details + comments for one issue.

    View source on GitHub
  • gh.pr_checks exec low

    gh pr checks

    List all CI checks for one PR + pass/fail status.

    View source on GitHub
  • gh.pr_close exec medium

    gh pr close <num>

    Close one PR without merging. Use for stale or abandoned PRs. Reopenable via the UI or `gh pr reopen`.

    View source on GitHub
  • gh.pr_list exec low

    gh pr list

    List open PRs for one repo.

    View source on GitHub
  • gh.pr_merge exec high

    gh pr merge <num> --<method>

    Merge an open PR. Squash, merge-commit, or rebase. Branch protection rules still apply — required checks/approvals must be satisfied or the merge is rejected. Use --auto in the GH UI for "merge when ready" instead; this action commits NOW.

    View source on GitHub
  • gh.pr_view exec low

    gh pr view

    Show details for one PR — title, body, status, reviews, checks.

    View source on GitHub
  • gh.release_list exec low

    gh release list

    List recent releases.

    View source on GitHub
  • gh.repo_clone_count exec low

    gh api repos/<repo>/traffic/clones

    Show last-14-day clone counts (requires push access on the repo).

    View source on GitHub
  • gh.repo_view exec low

    gh repo view

    Show repo summary — description, stars, default branch, latest release.

    View source on GitHub
  • gh.search_prs exec low

    gh search prs

    Search PRs across all of GitHub by query.

    View source on GitHub
  • gh.workflow_dispatch exec high

    gh workflow run <workflow>

    Trigger a workflow that supports workflow_dispatch. Pass ref + JSON inputs. Used for ad-hoc deploys, scripted rollbacks, or manual release flows.

    View source on GitHub
  • gh.workflow_list exec low

    gh workflow list

    List all workflows defined in one repo.

    View source on GitHub
  • gh.workflow_rerun exec medium

    gh run rerun <run-id>

    Re-run one workflow run. Useful after fixing a transient infrastructure issue. With --failed, only re-runs failed jobs.

    View source on GitHub
  • gh.workflow_run_list exec low

    gh run list

    List recent workflow runs across the repo.

    View source on GitHub
  • gh.workflow_run_logs exec low

    gh run view --log-failed

    Show logs from failed jobs in one run. Use for "why did CI break?".

    View source on GitHub
  • gh.workflow_run_view exec low

    gh run view

    Show job-by-job result for one workflow run.

    View source on GitHub