Runners

image: giglabo/claude-heretic:latest
runner: docker
provider: anthropic

extra:
  memory: "8g"
  cpus: "4.0"
  shm_size: "2g"
  network: host
  ports:
    - "3000:3000"
    - "5173:5173"
  capabilities:
    - SYS_PTRACE
  privileged: false

image: giglabo/claude-heretic:latest
runner: compose
provider: anthropic

extra:
  ports:
    - "3000:3000"

compose:
  services:
    db:
      image: postgres:16
      environment:
        POSTGRES_PASSWORD: devpass
      ports:
        - "5432:5432"
    redis:
      image: redis:7-alpine
      ports:
        - "6379:6379"

version: "3.8"
services:
  agent:              # always "agent" — do not use this name in compose.services
    image: ...
    environment: ...  # all profile env vars + secrets
    volumes: ...      # all profile volumes + MCP + session mounts
    labels:
      heretic.managed: "true"
      heretic.agent: <name>
      heretic.project: <dir>
      heretic.session: <session>
    stdin_open: true
    tty: true
    # extra.* fields mapped directly:
    network_mode: ...
    ports: [...]
    cap_add: [...]
    privileged: ...
    user: ...
    hostname: ...
    deploy:
      resources:
        limits:
          memory: ...
          cpus: ...
    shm_size: ...
    command: [...]    # if command or -- override present

  db: ...             # from compose.services
  redis: ...          # from compose.services

compose:
  services:
    db:
      image: postgres:16
      environment:
        POSTGRES_PASSWORD: devpass
    redis:
      image: redis:7-alpine

compose:
  networks:
    internal:
      driver: bridge
  services:
    db:
      image: postgres:16
      networks:
        - internal

image: giglabo/claude-heretic:latest
runner: compose
provider: anthropic

mcp:
  - name: my-local-server
    command: npx
    args: ["-y", "mcp-remote", "http://mcp-server:8080/sse"]

compose:
  services:
    mcp-server:
      image: my-mcp-server:latest
      environment:
        API_KEY: "${MY_API_KEY}"

# Generate a starter template
heretic-cli local-init --compose

# Edit to suit your project
vim .heretic/cli/compose.yaml

# Set runner: custom in the profile

image: giglabo/claude-heretic:latest
runner: custom
provider: anthropic

secrets:
  ANTHROPIC_API_KEY: ~/.heretic/get-anthropic-key.sh

env:
  ANTHROPIC_API_KEY: "${ANTHROPIC_API_KEY}"
  MY_DB_PASSWORD: "${MY_DB_PASSWORD}"

version: "3.8"

services:
  agent:
    image: giglabo/claude-heretic:latest
    volumes:
      - .:/workspace
    environment:
      - ANTHROPIC_API_KEY    # value comes from host env (injected by CLI)
    stdin_open: true
    tty: true
    working_dir: /workspace
    network_mode: host

  # Add additional services as needed
  # db:
  #   image: postgres:16
  #   environment:
  #     POSTGRES_PASSWORD: devpass
  #   ports:
  #     - "5432:5432"

version: "3.8"

services:
  agent:
    image: giglabo/claude-heretic:latest
    environment:
      - ANTHROPIC_API_KEY
      - GH_TOKEN
      - NODE_ENV=development
    volumes:
      - ${PWD}:/workspace
      - agent-home:/home/agent
    working_dir: /workspace
    stdin_open: true
    tty: true
    networks:
      - app
    depends_on:
      db:
        condition: service_healthy
      redis:
        condition: service_started

  db:
    image: postgres:16
    environment:
      POSTGRES_PASSWORD: devpass
      POSTGRES_DB: myapp
    volumes:
      - pgdata:/var/lib/postgresql/data
    ports:
      - "5432:5432"
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres"]
      interval: 5s
      timeout: 5s
      retries: 5
    networks:
      - app

  redis:
    image: redis:7-alpine
    ports:
      - "6379:6379"
    networks:
      - app

networks:
  app:
    driver: bridge

volumes:
  pgdata:
  agent-home: