gt:github

Description

# GitHub Tool Usage Guide Search, fetch, and analyze GitHub issues, PRs, and comments with caching. ## Quick Reference | Task | Command | |------|---------| | List unread notifications | `tools github notifications` | | Notifications for a repo | `tools github notifications -r owner/repo` | | Open unread mentions | `tools github notifications --reason mention --open` | | Mark notifications read | `tools github notifications --mark-read` | | Activity feed (last 7d) | `tools github activity --since 7d` | | Activity for specific user | `tools github activity -u username` | | Search with min stars | `tools github search "query" --min-stars 1000` | | Search repositories | `tools github search "query" --type repo --sort stars` | | Get issue with comments | `tools github issue <url>` | | Get last 5 comments | `tools github issue <url> --last 5` | | Comments since specific one | `tools github comments <url>#issuecomment-123 --since 123` | | Filter issue by body reactions | `tools github issue <url> --min-reactions 10` | | Filter comments by reactions | `tools github issue <url> --min-comment-reactions 5` | | Filter by positive reactions | `tools github issue <url> --min-reactions-positive 3` | | Exclude bots | `tools github issue <url> --no-bots` | | Search with min reactions | `tools github search "bug" --repo owner/repo --min-reactions 10` | | Search issues | `tools github search "error" --repo owner/repo --state open` | | Get PR with review comments | `tools github pr <url> --review-comments` | | Check auth status | `tools github status` | | Get file content | `tools github get <file-url>` | | Get specific lines | `tools github get <file-url> --lines 10-50` | | Get file to clipboard | `tools github get <file-url> -c` | | List workflow runs | `gh run list --repo owner/repo --created YYYY-MM-DD --limit 200` | | CI cost breakdown | `bun <skill-dir>/scripts/actions-cost.ts --repo owner/repo --date YYYY-MM-DD` | | Cross-repo cost scan | `bun <skill-dir>/scripts/actions-cost.ts --org <org> --date YYYY-MM-DD --cross-repo` | | Cost per branch | `bun <skill-dir>/scripts/actions-cost.ts --repo owner/repo --branch <branch> --from YYYY-MM-DD --to YYYY-MM-DD` | | Re-run failed jobs | `gh run rerun <run-id> --failed` | | Cancel a run | `gh run cancel <run-id>` | | Cache usage | `gh api /repos/{owner}/{repo}/actions/cache/usage` | ## URL Parsing The tool automatically parses these URL formats: - `https://github.com/owner/repo/issues/123` - `https://github.com/owner/repo/pull/456` - `https://github.com/owner/repo/issues/123#issuecomment-789` - `owner/repo#123` (shorthand) - `#123` or `123` (when in a git repo) When user provides a URL with `#issuecomment-XXX`, use `--since XXX` to fetch from that point. ## Get File Content Fetch raw file content from any GitHub file URL. ### Supported URL Formats - `https://github.com/owner/repo/blob/branch/path/to/file` - `https://github.com/owner/repo/blob/tag/path/to/file` - `https://github.com/owner/repo/blob/commit/path/to/file` - `https://github.com/owner/repo/blame/ref/path/to/file` - `https://raw.githubusercontent.com/owner/repo/ref/path/to/file` - `https://raw.githubusercontent.com/owner/repo/refs/heads/branch/path` - `https://raw.githubusercontent.com/owner/repo/refs/tags/tag/path` - All above with `#L10` or `#L10-L20` line references ### Examples ```bash # Get file from blob URL tools github get https://github.com/facebook/react/blob/main/package.json # Get specific lines from a file tools github get https://github.com/owner/repo/blob/main/src/index.ts --lines 10-50 # Get file from blame URL tools github get https://github.com/owner/repo/blame/v1.0.0/README.md # Get file from raw URL tools github get https://raw.githubusercontent.com/owner/repo/main/data.json # Override the ref to get a different version tools github get https://github.com/owner/repo/blob/main/file.ts --ref v2.0.0 # Copy to clipboard instead of stdout tools github get https://github.com/owner/repo/blob/main/file.ts -c #

Security Status