HolyCode: Docker Container for Persistent AI Coding Agent Environments

HolyCode is a Docker container built with Claude Code to solve environment switching problems. The developer created it to have one Docker setup that can run anywhere without rebuilding the entire environment.

How Claude Code Was Used

• Iterated the Docker/runtime architecture quickly
• Debugged browser/container issues (Chromium + Xvfb + Playwright flow)
• Refined startup and recovery flow so rebuilds are repeatable
• Improved documentation and troubleshooting steps for predictable setup

Features

• Keeps sessions, settings, and plugins in persistent storage so rebuilds don't wipe progress
• Ships with prewired browser tooling for agent workflows
• Uses reliability defaults for daily use (shm_size: 2g, permission mapping, process supervision)
• Supports Claude, OpenAI, Gemini, and other provider workflows through OpenCode

Quick Start

Create a docker-compose.yml file:

services:
  holycode:
    image: coderluii/holycode:latest
    restart: unless-stopped
    shm_size: 2g
    ports:
      - "4096:4096"
    volumes:
      - ./data/opencode:/home/opencode
      - ./workspace:/workspace
    environment:
      - PUID=1000
      - PGID=1000
      - ANTHROPIC_API_KEY=your-key-here

Then run:

docker compose up -d

Open http://localhost:4096 to access the environment.

The container is available at coderluii/holycode:latest on Docker Hub and the source is on GitHub. The developer mentioned they can share exact backup/restore and upgrade/rollback routines in follow-up comments.