github

Base directory for this skill: /home/hazeruno/.config/opencode/skills/github

Interact with GitHub repositories through the Model Context Protocol (MCP) server for GitHub.

When to Use

• Managing repository files (create, update, get contents)
• Working with issues (create, update, list, comment)
• Managing pull requests (create, review, merge, get status)
• Searching GitHub (repositories, code, issues, users)
• Creating and managing branches
• Forking repositories

Quick Start

Run the CLI script with bun (use absolute path):

bun /home/hazeruno/.config/opencode/skills/github/scripts/github.ts <command> [options]

Available Commands

Repository Operations

| Command | Description | |---------|-------------| | create-repository | Create a new GitHub repository | | fork-repository | Fork a repository to your account | | search-repositories | Search for repositories |

File Operations

| Command | Description | |---------|-------------| | get-file-contents | Get file or directory contents | | create-or-update-file | Create or update a single file | | push-files | Push multiple files in a single commit |

Branch Operations

| Command | Description | |---------|-------------| | create-branch | Create a new branch | | list-commits | List commits in a repository |

Issue Operations

| Command | Description | |---------|-------------| | create-issue | Create a new issue | | get-issue | Get issue details | | list-issues | List repository issues | | update-issue | Update an existing issue | | add-issue-comment | Add a comment to an issue |

Pull Request Operations

| Command | Description | |---------|-------------| | create-pull-request | Create a new PR | | get-pull-request | Get PR details | | list-pull-requests | List repository PRs | | get-pull-request-files | Get files changed in PR | | get-pull-request-status | Get PR status checks | | get-pull-request-comments | Get PR review comments | | get-pull-request-reviews | Get PR reviews | | create-pull-request-review | Create a PR review | | merge-pull-request | Merge a PR | | update-pull-request-branch | Update PR branch from base |

Search Operations

| Command | Description | |---------|-------------| | search-repositories | Search repositories | | search-code | Search code across GitHub | | search-issues | Search issues and PRs | | search-users | Search GitHub users |

Global Options

• -t, --timeout <ms>: Call timeout (default: 30000)
• -o, --output <format>: Output format: text | markdown | json | raw

Common Examples

# Get file contents
bun /home/hazeruno/.config/opencode/skills/github/scripts/github.ts get-file-contents \
  --owner facebook --repo react --path README.md

# Create an issue
bun /home/hazeruno/.config/opencode/skills/github/scripts/github.ts create-issue \
  --owner myorg --repo myrepo --title "Bug report" --body "Description here"

# List open PRs
bun /home/hazeruno/.config/opencode/skills/github/scripts/github.ts list-pull-requests \
  --owner facebook --repo react --state open

# Search code
bun /home/hazeruno/.config/opencode/skills/github/scripts/github.ts search-code \
  --q "useState filename:*.tsx"

# Create a PR review
bun /home/hazeruno/.config/opencode/skills/github/scripts/github.ts create-pull-request-review \
  --owner myorg --repo myrepo --pull-number 123 \
  --body "LGTM!" --event APPROVE

Requirements

• Bun runtime
• mcporter package (embedded in script)
• GITHUB_TOKEN environment variable for authentication

Resources

• scripts/github.ts - Main CLI tool wrapping GitHub MCP server
• references/api_reference.md - Detailed parameter documentation for all commands