brainiac-github

GitHub webhook plugin for Brainiac — the multi-agent orchestration layer.

• PR Reviews — dispatches agents to address review feedback
• PR Comments — routes PR conversation to the assigned agent
• PR Merges — cleans up worktrees, emits hooks for card management plugins
• Workflow Runs — notifies on CI failures and deploy completions
• Issues — logs new issues for tracking

brainiac install github
brainiac restart

Config lives at ~/.brainiac/github.json:

{
  "webhook_secret": "your-github-webhook-secret",
  "repos": {}
}

Generate a webhook secret:

ruby -rsecurerandom -e 'puts SecureRandom.hex(20)'

1. Go to your repo → Settings → Webhooks → Add webhook
2. Payload URL: https://your-ngrok.ngrok-free.app/github
3. Content type: application/json
4. Secret: paste your webhook_secret
5. Events: Pull requests, Pull request reviews, Issue comments, Issues, Workflow runs

brainiac github setup     # Create config file from template
brainiac github config    # Show current configuration
brainiac github status    # Check if webhook endpoint is active

git clone https://github.com/stowzilla/brainiac-github.git
cd brainiac-github
bundle install
bundle exec rake test
bundle exec rubocop

MIT