@shopwarelabs/github-agent-tools5.0.1
GitHub CLI MCP servers for pull requests, issues, CI, and repositories, with enforcement that keeps the agent on the MCP tools.
Untested on omp
This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.
Reports 0
No reports yet.
Readme
GitHub Agent Tools
Experimental Community Project: Maintained by Shopware Labs, not an official Shopware product. Not affiliated with, endorsed by, or sponsored by GitHub, Anthropic, OpenAI, or any other platform or AI provider. Provider and product names are used only to describe compatibility. Provided as-is without warranty.
GitHub CLI tools for AI coding agents. Wraps the GitHub CLI (gh) behind MCP servers — pull requests, issues, CI runs, jobs, commits, search, labels, projects, releases, and repository file browsing — as first-class MCP tools, with hook-based enforcement that keeps the agent on the tools instead of raw gh bash calls.
The MCP servers use the assistant-neutral Model Context Protocol and can be integrated with MCP-capable coding agents. This repository provides tested github-mcp plugin packaging for Claude Code, Codex, and pi.
⚡ Quick Start
Packaged plugin requirements: gh CLI authenticated (gh auth login), jq, and Claude Code, Codex, or pi.
Claude Code
/plugin marketplace add shopwareLabs/github-agent-tools
/plugin install github-mcp@github-agent-tools
Restart Claude Code after installation for the MCP servers to initialize.
Codex
codex plugin marketplace add shopwareLabs/github-agent-tools
codex plugin add github-mcp@github-agent-tools
Start a new Codex task after installation. Open /hooks to review and trust the bundled enforcement hooks; Codex skips untrusted plugin hooks.
pi
Install from npm:
pi install npm:@shopwarelabs/github-agent-tools
Or install from git:
pi install git:github.com/shopwareLabs/github-agent-tools
Run one of the two, never both: installing from both sources loads the extension twice.
A new pi session or /reload loads the package.
The read server (gh-tooling) is always active. The write server (gh-tooling-write) is opt-in via enable_write_server: true in a .mcp-gh-tooling.json config file. Configuration is optional — the read server works out of the box when gh is authenticated.
Optional Claude Code setup: the companion plugin-setup plugin remains Claude Code-only because it uses Claude Code interaction and permission settings. Install it with /plugin install plugin-setup@github-agent-tools, ask Claude to "set up github-mcp", then uninstall it when setup is complete. Codex and pi users configure .mcp-gh-tooling.json manually as described in the plugin guide.
🧩 What's Inside
| Component | Description |
|---|---|
| 🔌 MCP | Two servers: gh-tooling (read tools) and gh-tooling-write (write tools, gated) |
| 🪝 Hooks | SessionStart directive + PreToolUse enforcement that redirects gh bash calls to the MCP tools |
See plugins/github-mcp/README.md for full configuration, the complete tool reference, and troubleshooting. See plugins/github-mcp/REFERENCE.md for per-tool parameter docs.
🧪 Testing
# One-time: install BATS locally
./.github/scripts/setup-bats.sh
# Run the suites
.bats/bats-core/bin/bats -r plugin-tests/
⚖️ License
MIT.