[H1][GITHUB-TOOLS]
<br>Dictum: Standardized invocation reduces agent errors.
Invokes gh CLI commands through Python wrapper.
[IMPORTANT] Zero-arg commands default to state=open, limit=30. All commands use positional args.
[1][COMMANDS]
| [CMD] | [ARGS] | [PURPOSE] |
|---|---|---|
| issue-list | [state] [limit] | List issues |
| issue-view | <number> | View issue details |
| issue-create | <title> [body] | Create issue |
| issue-comment | <number> <body> | Comment on issue |
| issue-close | <number> | Close issue |
| issue-edit | <number> [title] [body] | Edit issue |
| issue-reopen | <number> | Reopen issue |
| pr-list | [state] [limit] | List PRs |
| pr-view | <number> | View PR details |
| pr-create | <title> [body] [base] | Create PR |
| pr-diff | <number> | Get PR diff |
| pr-files | <number> | List PR files |
| pr-checks | <number> | View PR checks |
| pr-merge | <number> | Merge PR (squash) |
| pr-review | <number> <event> [body] | Review PR |
| pr-close | <number> | Close PR |
| pr-ready | <number> | Mark PR ready |
| run-list | [limit] | List workflow runs |
| run-view | <run_id> | View run details |
| run-logs | <run_id> [failed] | Get run logs |
| run-rerun | <run_id> | Rerun failed jobs |
| run-cancel | <run_id> | Cancel run |
| workflow-list | — | List workflows |
| workflow-view | <workflow> | View workflow YAML |
| workflow-run | <workflow> [ref] | Trigger workflow |
| search-repos | <query> [limit] | Search repositories |
| search-code | <query> [limit] | Search code |
| search-issues | <query> [limit] | Search issues |
| project-list | [owner] | List projects |
| project-view | <project> [owner] | View project |
| project-item-list | <project> [owner] | List project items |
| project-create | <title> [owner] | Create project |
| project-close | <project> [owner] | Close project |
| project-item-add | <project> <url> [owner] | Add item to project |
| project-field-list | <project> [owner] | List project fields |
| release-list | [limit] | List releases |
| release-view | <tag> | View release |
| cache-list | [limit] | List caches |
| cache-delete | <cache_key> | Delete cache |
| label-list | — | List labels |
| repo-view | [repo] | View repository |
| api | <endpoint> [method] | Raw API call |
| discussion-list | [category] [limit] | List discussions |
| discussion-view | <number> | View discussion |
| discussion-create | <category_id> <title> <body> | Create discussion |
| discussion-comment | <discussion_id> <body> | Comment on discussion |
| discussion-close | <discussion_id> | Close discussion |
[2][USAGE]
bash
# Zero-arg commands
uv run .claude/skills/github-tools/scripts/gh.py issue-list
uv run .claude/skills/github-tools/scripts/gh.py pr-list
uv run .claude/skills/github-tools/scripts/gh.py run-list
uv run .claude/skills/github-tools/scripts/gh.py workflow-list
uv run .claude/skills/github-tools/scripts/gh.py label-list
uv run .claude/skills/github-tools/scripts/gh.py release-list
uv run .claude/skills/github-tools/scripts/gh.py repo-view
# With positional args
uv run .claude/skills/github-tools/scripts/gh.py issue-list closed 50
uv run .claude/skills/github-tools/scripts/gh.py issue-view 42
uv run .claude/skills/github-tools/scripts/gh.py issue-create "Bug report" "Details here"
uv run .claude/skills/github-tools/scripts/gh.py issue-comment 42 "This is a comment"
uv run .claude/skills/github-tools/scripts/gh.py issue-close 42
uv run .claude/skills/github-tools/scripts/gh.py pr-view 99
uv run .claude/skills/github-tools/scripts/gh.py pr-create "Feature" "Description" main
uv run .claude/skills/github-tools/scripts/gh.py pr-merge 99
uv run .claude/skills/github-tools/scripts/gh.py pr-review 99 APPROVE "LGTM"
uv run .claude/skills/github-tools/scripts/gh.py run-list 10
uv run .claude/skills/github-tools/scripts/gh.py run-view 12345
uv run .claude/skills/github-tools/scripts/gh.py run-logs 12345 failed
uv run .claude/skills/github-tools/scripts/gh.py workflow-run ci.yml main
uv run .claude/skills/github-tools/scripts/gh.py search-repos "nx monorepo" 10
uv run .claude/skills/github-tools/scripts/gh.py search-code "dispatch table" 10
uv run .claude/skills/github-tools/scripts/gh.py project-view 1
uv run .claude/skills/github-tools/scripts/gh.py project-item-list 1
uv run .claude/skills/github-tools/scripts/gh.py api "/repos/{owner}/{repo}/issues" GET
[3][OUTPUT]
Commands return: {"status": "success|error", ...}.
| [INDEX] | [PATTERN] | [RESPONSE] |
|---|---|---|
| [1] | List commands | {items: object[]} |
| [2] | View commands | {item: object} |
| [3] | Mutation commands | {number: int, action: bool} |
| [4] | Search commands | {query: string, results: object[]} |
| [5] | Diff commands | {number: int, diff: string} |