HolyClaude provides a comprehensive, pre-configured AI development workstation within a Docker container, designed to streamline the setup of Anthropic's Claude Code and related tools. It targets developers seeking to bypass complex environment configuration, offering immediate access to a web UI, headless browser, multiple AI CLIs, and over 50 development utilities, thereby accelerating the build process.

How It Works

This project packages Claude Code, a CloudCLI web UI, a headless Chromium browser with Playwright, and a suite of development tools into a Docker image. It tackles common Dockerization hurdles such as permission mismatches, insufficient shared memory, and intricate dependency management. Utilizing s6-overlay for process supervision, HolyClaude ensures robust service management, including automatic restarts and graceful shutdowns. Authentication for Claude Code is handled directly via existing subscriptions or API keys, securely managed through bind-mounted volumes.

Quick Start & Requirements

• Primary Install/Run: Create a docker-compose.yaml file and run docker compose up -d.
• Prerequisites: Docker, Docker Compose, and an active Claude Code subscription or Anthropic API key.
• Resource Footprint: Setup is near-instantaneous post-Docker installation.
• Links: Web UI accessible at http://localhost:3001.

Highlighted Details

• Unified AI CLI Access: Integrates Claude Code with four other AI CLIs (Gemini, OpenAI Codex, Cursor, TaskMaster AI) within a single container.
• Extensive Tooling: Comes pre-loaded with over 50 development tools, including Node.js, Python, Git, and various utilities for code quality, deployment, and data manipulation.
• Headless Browser Integration: Features a fully configured Chromium instance with Xvfb and Playwright, enabling browser automation and testing out-of-the-box.
• Simplified Deployment: Achieves a "one command" setup, drastically reducing the typical 1-2 hour manual configuration time.

Maintenance & Community

The project is actively maintained by its creator, CoderLuii, who uses it daily. Community interaction is facilitated through GitHub Discussions for general queries and ideas, and GitHub Issues for bug reports and feature requests. A roadmap outlines planned enhancements, including ARM-native builds and VS Code tunnel integration.

Licensing & Compatibility

• License: MIT License, permitting broad use.
• Compatibility: Supports Linux (amd64/arm64), macOS, and Windows (WSL2). Kubernetes support is planned.

Limitations & Caveats

An upstream bug may affect the CloudCLI's "Continue in Shell" button; the Web Terminal plugin is a viable alternative. CloudCLI account persistence can be an issue on network mounts. Web push notifications are not supported within the CloudCLI interface.