docker/docker-compose.native.yml

services:
  cli:
    image: ${HEADROOM_IMAGE:-ghcr.io/chopratejas/headroom:latest}
    entrypoint: ["headroom"]
    working_dir: /workspace
    stdin_open: true
    tty: true
    environment:
      HOME: /tmp/headroom-home
      # Canonical Headroom filesystem contract (issue #175). Forwarded into
      # the container so the proxy resolves state/config to the bind-mounted
      # /tmp/headroom-home/.headroom path. HEADROOM_WORKSPACE (above) remains
      # the Docker bind-mount source and is intentionally different.
      HEADROOM_WORKSPACE_DIR: /tmp/headroom-home/.headroom
      HEADROOM_CONFIG_DIR: /tmp/headroom-home/.headroom/config
    volumes:
      - ${HEADROOM_WORKSPACE:-.}:/workspace
      - ${HEADROOM_HOST_HOME:?set HEADROOM_HOST_HOME}/.headroom:/tmp/headroom-home/.headroom
      - ${HEADROOM_HOST_HOME:?set HEADROOM_HOST_HOME}/.claude:/tmp/headroom-home/.claude
      - ${HEADROOM_HOST_HOME:?set HEADROOM_HOST_HOME}/.codex:/tmp/headroom-home/.codex
      - ${HEADROOM_HOST_HOME:?set HEADROOM_HOST_HOME}/.gemini:/tmp/headroom-home/.gemini
    command: ["--help"]

  proxy:
    image: ${HEADROOM_IMAGE:-ghcr.io/chopratejas/headroom:latest}
    entrypoint: ["headroom", "proxy"]
    working_dir: /workspace
    restart: unless-stopped
    environment:
      HOME: /tmp/headroom-home
      HEADROOM_HOST: 0.0.0.0
      # Canonical Headroom filesystem contract (issue #175). See `cli` service
      # above for rationale.
      HEADROOM_WORKSPACE_DIR: /tmp/headroom-home/.headroom
      HEADROOM_CONFIG_DIR: /tmp/headroom-home/.headroom/config
    ports:
      - "${HEADROOM_PORT:-8787}:${HEADROOM_PORT:-8787}"
    volumes:
      - ${HEADROOM_WORKSPACE:-.}:/workspace
      - ${HEADROOM_HOST_HOME:?set HEADROOM_HOST_HOME}/.headroom:/tmp/headroom-home/.headroom
      - ${HEADROOM_HOST_HOME:?set HEADROOM_HOST_HOME}/.claude:/tmp/headroom-home/.claude
      - ${HEADROOM_HOST_HOME:?set HEADROOM_HOST_HOME}/.codex:/tmp/headroom-home/.codex
      - ${HEADROOM_HOST_HOME:?set HEADROOM_HOST_HOME}/.gemini:/tmp/headroom-home/.gemini
    command: ["--host", "0.0.0.0", "--port", "${HEADROOM_PORT:-8787}"]