HolyClaude
One-command AI development workstation: Claude Code, web UI, 8 AI CLIs, headless browser, and 50+ dev tools — containerized and ready.
- Source repo
- CoderLuii/HolyClaude
- Stars
- ★ 2.6k
- Last updated
- 4d ago
- License
- MIT
- Primary language
- JavaScript
- FA score
- 64/100 · Some gaps
At a glance
- How it runs
- Works with
- Platform-specificClaude Code · OpenAI API · Claude APIChatGPT (Partial support)
- Cost
- Free software; you pay for model usage
- Setup effort
- Medium · a few setup steps
- You'll need
- Typical use
- A developer who wants to skip the 1-2 hour manual setup of Claude Code, Chromium, and Playwright, and start with a single docker compose up.
- Not a fit if
- Users with tight disk or bandwidth: the full image is a large download
- Teams unwilling to grant SYS_ADMIN, SYS_PTRACE, or seccomp=unconfined to a container
- Source review
- 64/100 · Some gaps
What does this agent do, and when should you use it?
HolyClaude is a pre-configured Docker container that delivers a complete AI coding environment out of the box. It bundles the Claude Code CLI with a web UI via CloudCLI, Chromium headless browser with Playwright, eight AI CLIs (including Gemini, Codex, Cursor), and over 50 development tools (Node.js, Python packages, system utilities). The container uses s6-overlay for process supervision, ensuring auto-restart and graceful shutdown. Data and workspace are persisted via bind mounts, and it supports both AMD64 and ARM64 architectures with full and slim image variants. HolyClaude works with existing Anthropic subscriptions for authentication without extra configuration.
HolyClaude sets up a development environment inside a Docker container. On startup, it launches the CloudCLI web UI on port 3001, providing a browser interface to Claude Code. The environment includes pre-installed Chromium, Xvfb, and Playwright for browser automation and screenshots. It supports multiple AI providers through eight bundled CLIs: claude, gemini, codex, cursor, task-master, junie, opencode, and pi. Configuration for these providers is done via environment variables like GEMINI_API_KEY, OPENAI_API_KEY, and CURSOR_API_KEY. Notifications via Apprise (Discord, Telegram, etc.) can be enabled with simple environment variables. The container uses s6-overlay for process management, auto-restarting crashed services. Persistent configuration and workspace are stored in ./data/claude and ./workspace respectively, surviving container rebuilds.
- A developer who wants to skip the 1-2 hour manual setup of Claude Code, Chromium, and Playwright, and start with a single docker compose up.
- Self-hosting an AI coding workstation on a Synology NAS or Raspberry Pi (ARM64) with secure remote access via Tailscale or Cloudflare Tunnel.
- A team that wants a uniform AI coding environment (Claude Code, Gemini, Codex, etc.) across all members using the same Docker image.
- A QA engineer needing ready-to-use browser automation and screenshot capabilities with Playwright and Chromium, already configured.
- An AI enthusiast who wants to compare outputs from eight different AI CLIs (Claude, Gemini, Codex, etc.) without installing each separately.
- A developer working in an environment with limited disk space who opts for the slim image and lets Claude install additional packages on demand.
How do you install or deploy this agent?
Requires Docker and Docker Compose. Create a folder, then create a docker-compose.yaml file. You can use the 'Quick Start' template (minimal) or the 'Full Configuration' template (with all options) from the README. Then run 'docker compose up -d'. By default, the web UI is exposed on 127.0.0.1:3001.
How do you use this agent?
After starting, open http://localhost:3001 in your browser. Create a CloudCLI account (takes about 10 seconds), then sign in with your Anthropic account (supports OAuth from Max/Pro plan or an API key). You can now use Claude Code through the web UI, or access the command line inside the container to run 'claude', 'gemini', 'codex', etc. For other AI CLIs, set the required environment variables (e.g., GEMINI_API_KEY, OPENAI_API_KEY).
What are this agent's strengths and limitations?
- Saves 1-2 hours of manual setup with a 30-second docker compose up that pre-configures tools, browser, and permissions.
- Includes over 50 dev tools: Node.js 26, Python 3 with popular packages (pandas, numpy, playwright), system tools (ripgrep, git, gh), and more.
- Supports eight AI CLIs in one container, eliminating separate installs and configuration for each provider.
- Uses s6-overlay for process supervision with auto-restart, crash recovery, and graceful shutdown.
- Persistent bind mounts (./data/claude, ./workspace) survive container rebuilds, preserving Claude config, auth, and code.
- Slim image (about 2.4GB) available for disk-constrained environments, with on-demand package installation via Claude.
- Full image is heavy (about 4.1GB compressed), requiring significant disk and bandwidth.
- Primary dependency on Claude Code; other AI CLIs require their own subscriptions or API keys, adding provider lock-in.
- Default Docker config requires extra capabilities (SYS_ADMIN, SYS_PTRACE, seccomp=unconfined) and 2GB shared memory, which may raise security concerns.
- CloudCLI web UI bound to localhost; remote access requires setting up Tailscale or Cloudflare Tunnel, adding complexity.
- CloudCLI account is not persisted by default, so it must be recreated after container rebuild (quick but takes ~10 seconds).
- Documentation strongly advises against exposing the CloudCLI port to the public internet, citing high security risk.
How does this agent compare with similar options?
Compared to other Dockerized AI coding environments, HolyClaude offers a more comprehensive pre-configured setup, including eight AI CLIs, headless browser, and s6-overlay process management. Many similar projects might only provide a Docker image for Claude Code without the web UI, browser automation, or multi-provider support.
Key facts side by side with the most closely related agents.
| Agent | Source review | Form / cost | Stars | Updated | Language | Full support on |
|---|---|---|---|---|---|---|
| HolyClaude This agent | 64 · Some gaps | Self-hosted serviceFree + model costs | ★ 2.6k | 4d ago | JavaScript | Claude Code · OpenAI API · Claude API |
| Pydantic Deep Agents | 68 · Some gaps | CLIFree + model costs | ★ 1.1k | 13d ago | Python | OpenAI API · Claude API |
| Camofox Browser | 52 · Major gaps | Self-hosted serviceFree | ★ 12k | 14d ago | JavaScript | — |
| CamoFox Browser Server | 72 · Some gaps | Self-hosted serviceFree | ★ 424 | 27d ago | JavaScript | Claude Code |
How does FollowAgents rate this agent?
Why each dimension lost points
Evidence shows the container runs as non-root by default and provides PUID/PGID mapping, but the compose template includes broad capabilities like SYS_ADMIN, SYS_PTRACE, and seccomp=unconfined, and there is no user confirmation mechanism. Data flow transparency is partially addressed: README explains credential storage and direct provider connections, but internal data flows are not detailed. Sensitive data handling includes scripts to protect credential file permissions, but no full encryption or key management. Dependency security includes SBOM and vulnerability scanning, but no specific vulnerability reports. External effects: container binds to localhost by default, but SSH and port mapping options are provided. Rollback: version tags and upgrade instructions exist, but no automatic rollback mechanism. Source attribution: clear author and license, but publisher is unverified.
Self-consistency: version numbers in README, compose files, and test scripts are consistent, but no complete architecture documentation. Dependency availability: Docker images and dependency locking exist, but no offline installation option. Failure messages: test scripts have detailed error output, but user documentation troubleshooting is incomplete.
Audience and scenarios: README clearly targets developers and provides multiple use cases. Capability boundaries: lists included tools and features, but no explicit limitations. Trigger precision: provides environment variables and configuration options, but no detailed trigger conditions. Environment fit: supports multiple platforms and architectures, but no Kubernetes deployment.
Information architecture: README is well-structured with table of contents and detailed sections. Install notes: provides quick start and full configuration templates. Naming stability: version and tag naming is consistent. Examples and FAQ: provides examples and common issues, but no complete FAQ. Known limitations: has a known issues section, but not detailed. License: MIT license is clear. Versioning and changelog: has CHANGELOG and version tags. Maintenance responsibility: has contribution guidelines and support channels, but no explicit maintainer.
Output usability: provides web UI and CLI, output formats are clear. Marginal value: provides pre-configured AI development environment, saving setup time. Cost benefit: free and open source, but requires user's own AI subscription or API keys.
Claim traceability: version and feature claims in README are consistent with checks in test scripts. Cross-source corroboration: information on Docker Hub and GitHub is consistent. Fact-inference separation: README distinguishes facts and inferences, but no detailed verification methods.
- The container includes broad capabilities like SYS_ADMIN, SYS_PTRACE, and seccomp=unconfined by default; consider restricting these in untrusted environments.
- The publisher is unverified; review image provenance and integrity before deployment.
- Dependency security scan results are not public; run your own vulnerability scanning.
Recent releases
Latest entries from the project's GitHub Releases. Notes are quoted from upstream as written, not rewritten or tested by FollowAgents.
-
Release notes excerpt
10/14/2026 Changed - Updated Node to 26.12.0, Claude Code to 2.1.300, Gemini CLI to 0.64.0, Junie to stable 3659.4 and OpenCode to 1.19.0. - Updated Chromium to 155.0.8059.39 and aligned Node and Python Playwright at 1.64.0. - Updated compatible developer, deployment, Python and optional Docker client tools from official upstream packages. - Added disk and swap capacity preparation to published Full-image monitoring before scanner installation, with disk and memory diagnostics retained in the job log. - Updated Azure CLI to 2.91.0 while retaining its strict embedded-runtime probes. …View on GitHub ↗ -
Release notes excerpt
10/10/2026 Changed - Updated Node to 26.11.1, Claude Code to 2.1.296, Gemini CLI to 0.63.0, Codex to 0.162.1, Junie to stable 3579.5 and OpenCode to 1.18.35. - Updated compatible developer and deployment tools using official upstream packages. - EAS, Netlify and Vercel keep their official dependency trees. - Updated Syft to 1.54.1, Grype to 0.120.1 and the artifact upload and download actions to 7.0.2 and 8.0.2. …View on GitHub ↗ -
Release notes excerpt
10/06/2026 Changed - Updated Node to 26.10.0 and compatible AI CLI, developer-tool and Python packages from official upstream releases. - Updated Vercel to official 62.4.0 and Apprise to 2.0.1. Kept legacy email encryption settings working in the notification integration. - Added source checks for pull requests and master, plus scheduled released-image dependency scans. - Added weekly Docker and GitHub Actions dependency update checks. …View on GitHub ↗