docker-compose.yml

services:
  layman:
    build: .
    image: layman
    container_name: layman
    ports:
      - "127.0.0.1:8880:8880"
    volumes:
      # Mount the host user's ~/.claude so the installer can write global hooks and commands
      - ${HOME}/.claude:/root/.claude
      # Mount ~/.config so the installer can detect and write commands for optional clients
      # (e.g. OpenCode at ~/.config/opencode/commands/). New XDG-based clients are covered
      # automatically — no docker-compose changes needed when support for a new client is added.
      - ${HOME}/.config:/root/.config
      # Mount ~/.vibe so the installer can detect Mistral Vibe, install the /layman skill,
      # and the session log watcher can tail messages.jsonl files for passive monitoring.
      - ${HOME}/.vibe:/root/.vibe
      # Mount ~/Documents/Cline so the installer can detect Cline and write hook scripts
      # to ~/Documents/Cline/Hooks/ for session monitoring and tool call approval.
      - ${HOME}/Documents/Cline:/root/Documents/Cline
      # Mount ~/.codex so the installer can detect Codex, write hook scripts to
      # ~/.codex/hooks/layman/, and update ~/.codex/hooks.json.
      - ${HOME}/.codex:/root/.codex
    environment:
      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY:-}
      - OPENAI_API_KEY=${OPENAI_API_KEY:-}
      - LAYMAN_API_KEY=${LAYMAN_API_KEY:-}
      - LAYMAN_URL=http://localhost:8880
      # HOST_HOME is the real home directory on the host machine. The installer uses it
      # to write correct absolute paths into ~/.codex/hooks.json — Codex runs on the host
      # and executes those paths literally, so they must be host paths, not /root/... paths.
      - HOST_HOME=${HOME}
    command: >
      node packages/server/dist/index.js start
      --host 0.0.0.0
      --no-open
      --hook-url http://localhost:8880
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "node", "-e", "fetch('http://localhost:8880/api/health').then(r=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))"]
      interval: 5s
      timeout: 3s
      retries: 5
      start_period: 5s