gh-pr-webhook-hooks

A small Claude Code plugin that turns CI feedback into a push instead of a poll.

When Claude Code creates a PR or pushes to a branch, this plugin reminds the agent to subscribe to GitHub PR activity via the GitHub MCP server. From that point on, CI results, status changes, and review comments stream into the agent's context as <github-webhook-activity> messages — no polling required.

Why

Agents are inconsistent about polling. Tell one to "check CI in a few minutes" and it will sometimes do it, sometimes drift, sometimes declare victory before tests finish. Making the result arrive in the agent's context — rather than requiring the agent to remember to fetch it — closes the loop reliably.

This is the same idea as the broader "give the agent context, not steering prompts" pattern: the more you can make relevant data show up automatically, the less the agent has to remember to do.

What's in the plugin

Two PostToolUse hooks:

• post-pr-create.sh — fires after mcp__github__create_pull_request. Tells the agent to call mcp__github__subscribe_pr_activity for the new PR.
• post-push.sh — fires after any git push. Tells the agent to subscribe to the PR for the pushed branch (if not already subscribed).

Both hooks emit guidance text — they don't take action themselves. The agent reads the guidance and makes the MCP call.

Requirements

• Claude Code with plugin support
• The GitHub MCP server enabled, exposing mcp__github__create_pull_request and mcp__github__subscribe_pr_activity

Install

/plugin install GerardsCuriousTech/gh-pr-webhook-hooks

Notes

• The hooks are intentionally tool-agnostic — they don't assume npm, cargo, or any specific verify command. They just nudge the agent to use the project's own build/test commands when fixing failures.
• If your project does not use the GitHub MCP server, this plugin is a no-op for the agent — the guidance text will appear but the agent has no subscribe_pr_activity tool to call.

License

MIT