Files
claude-hub/README.dockerhub.md
Jonathan Flatt c7863283bb feat: Add Docker Hub automated builds and publishing
- Add GitHub Actions workflow for automated Docker builds
- Configure staging builds on main/master branch pushes
- Configure release builds on version tags (v*.*.*)
- Support multi-platform builds (amd64, arm64)
- Auto-update Docker Hub README on main branch pushes
- Add comprehensive Docker Hub documentation
- Create publish script for manual releases
- Update docker-compose for public use

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-05-22 20:32:00 -05:00

2.5 KiB

Claude GitHub Webhook

A webhook service that enables Claude AI to respond to GitHub mentions and execute commands within repository contexts.

Quick Start

docker pull intelligenceassist/claude-github-webhook:latest

docker run -d \
  -p 8082:3002 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e GITHUB_TOKEN=your_github_token \
  -e GITHUB_WEBHOOK_SECRET=your_webhook_secret \
  -e ANTHROPIC_API_KEY=your_anthropic_key \
  -e BOT_USERNAME=@YourBotName \
  -e AUTHORIZED_USERS=user1,user2 \
  intelligenceassist/claude-github-webhook:latest

Features

  • 🤖 Responds to GitHub mentions in issues and PRs
  • 🔧 Executes Claude Code in isolated containers
  • 🏷️ Auto-tags issues based on content analysis
  • 🔍 Automated PR reviews when checks pass
  • 🔒 Secure webhook signature verification
  • 📊 Health check endpoint for monitoring

Docker Compose

version: '3.8'

services:
  claude-webhook:
    image: intelligenceassist/claude-github-webhook:latest
    ports:
      - "8082:3002"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - GITHUB_TOKEN=${GITHUB_TOKEN}
      - GITHUB_WEBHOOK_SECRET=${GITHUB_WEBHOOK_SECRET}
      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
      - BOT_USERNAME=@YourBotName
      - AUTHORIZED_USERS=user1,user2
    restart: unless-stopped

Environment Variables

Required

  • GITHUB_TOKEN - GitHub personal access token
  • GITHUB_WEBHOOK_SECRET - Secret for webhook validation
  • ANTHROPIC_API_KEY - Anthropic API key for Claude

Optional

  • BOT_USERNAME - Bot mention trigger (default: @ClaudeBot)
  • AUTHORIZED_USERS - Comma-separated authorized users
  • CLAUDE_USE_CONTAINERS - Enable container mode (default: 1)
  • PORT - Server port (default: 3002)

GitHub Setup

  1. Go to Settings → Webhooks in your repository
  2. Add webhook:
    • Payload URL: http://your-server:8082/api/webhooks/github
    • Content type: application/json
    • Secret: Same as GITHUB_WEBHOOK_SECRET
    • Events: Issues, Issue comments, Pull requests

Usage

Mention your bot in any issue or PR comment:

@YourBotName Can you analyze this code and suggest improvements?

Tags

  • latest - Most recent stable version
  • 0.1.0 - Initial release

License

MIT