claude-hub provides an AI-powered webhook service that integrates Claude Code directly into GitHub workflows, enabling autonomous code assistance via pull requests and issues. It targets developers seeking to automate feature implementation, code reviews, and CI/CD monitoring, offering seamless, end-to-end development directly within their existing GitHub environment.

How It Works

A webhook receiver spawns isolated Docker containers per GitHub event. Claude Code autonomously analyzes repos, implements features, reviews code, manages PRs, and monitors CI/CD pipelines. This enables multi-hour operations, dependency resolution, and adaptive problem-solving via container isolation for security and stateless execution.

Quick Start & Requirements

• Primary Install/Run: Clone the repository, configure .env with GitHub token and bot details, run ./scripts/setup/setup-claude-interactive.sh for Claude authentication, start the service with docker compose up -d, and create a tunnel using cloudflared.
• Prerequisites: A Claude Max subscription (5x or 20x plans) is mandatory; Claude Pro is insufficient. Requires a dedicated GitHub bot account with a Personal Access Token (PAT), Docker, and Cloudflare Tunnel for the quick start. Node.js 20+ is needed for contributing.
• Links: Quick Start Guide, Discord, Documentation, Complete Setup, Setup Container Guide, Authentication Guide, Complete Workflow.
• Setup Time: Estimated at 10 minutes for the quick start.

Highlighted Details

• Autonomous Workflow: Handles end-to-end feature implementation, intelligent PR management (creation, review, merging), CI/CD integration (build monitoring, failure handling), and long-running tasks (hours).
• Performance: Features repository caching for sub-second responses, parallel test execution, and conditional Docker builds.
• Security: Implements webhook signature verification (HMAC-SHA256), container isolation, fine-grained GitHub token scoping, and pre-commit credential scanning.
• Authentication Flexibility: Supports Claude Max subscription-based authentication, direct Anthropic API keys, or AWS Bedrock integration.

Maintenance & Community

The README provides links to Discord and comprehensive documentation, but does not detail specific contributors, community channels beyond Discord, or a public roadmap.

Licensing & Compatibility

The project is released under the MIT License, which is permissive for commercial use and integration with closed-source projects.

Limitations & Caveats

A significant adoption blocker is the mandatory Claude Max subscription, representing a substantial cost and dependency. The current setup requires manual creation of a GitHub bot account, though a future GitHub App release is planned. The quick start relies on Cloudflare Tunnel, necessitating external tunneling for initial testing.