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.