github

github

GitHub notifications for Claude Code. Push events, PR activity, workflow failures, and issue changes delivered as channel messages.

Install

# As a Claude Code plugin
claude plugin install github@bearly

# Launch with channel support (required during research preview)
claude --dangerously-load-development-channels server:github

How it works

┌─────────────┐     ┌──────────────────┐     ┌──────────────┐
│ Claude Code  │◀───││  MCP Channel    │◀────││  GitHub API │
│  (session)   │    ││  (polls every   │     ││  (REST v3)  │
└─────────────┘     │   30 seconds)    │     └──────────────┘
                    └──────────────────┘
                           │
                    ┌──────┘
               ┌──────────────────┐
               │ .beads/          │
               │ github-cursor.jso│
               └──────────────────┘

• GitHub REST API polled for repo events, workflow runs, and PR activity
• MCP channels push notifications into Claude Code's context as <channel> tags
• Cursor persistence in .beads/github-cursor.json — only new events delivered
• Auto-detect repo from git remote URL in cwd
• Token resolution: GITHUB_TOKEN env var, then gh auth token

Events monitored

Type	Channel tag type=	What
Push events	push	New commits pushed to branches
Workflow runs	workflow	CI/CD completions (failures highlighted)
Pull requests	pr	Opened, merged, reviewed, commented
Issues	issue	Opened, closed, assigned, commented

Commands

Once installed, use /github in Claude Code:

Command	What
/github	Recent events summary
/github status	Recent events summary
/github runs	Workflow runs
/github runs --failed	Failed runs only
/github prs	Open PRs with review status

Tools

Tool	Description
github_status	Recent events summary across monitored repos
github_runs	Workflow runs (filter by status/conclusion)
github_prs	Open PRs with review status

Configuration

# CLI args
bun server.ts --repos beorn/km,beorn/bearly --poll-interval 30 --events push,workflow_run,pull_request,issues

# Environment
GITHUB_REPOS=beorn/km GITHUB_POLL_INTERVAL=30 GITHUB_EVENTS=push,workflow_run

Option	Default	Description
--repos	Auto-detect from git remote	Comma-separated owner/repo
--poll-interval	30	Seconds between polls
--events	push,workflow_run,pull_request,issues	Event types to monitor

License

MIT