roboco/docker/agent-grok.Dockerfile

# Grok (xAI) Agent Image
# =============================================================================
# Runs Grok Build through xAI's official `grok` CLI, authenticated by the
# SuperGrok subscription via a mounted ~/.grok/auth.json — the parity analogue of
# the Claude Code path's mounted ~/.claude (no metered API key). Reuses the base
# image's roboco venv + uv + the RoboCo MCP gateway servers. The entrypoint
# renders ~/.grok/config.toml (the gateway) + the per-role grok flags from the
# mounted mcp-config.json (see roboco.llm.providers.grok_cli_config) and runs the
# CLI headless. One runtime image serves every role — role behaviour comes from
# the mounted system prompt / manifest / mcp-config, exactly as on the Claude path.
# =============================================================================

FROM roboco-agent-base

USER root

# Install the official grok CLI (Grok Build) for the agent user. The installer's
# default is $HOME/.grok/bin, so the binary lands at ~/.grok/bin/grok alongside
# its runtime (downloads / bundled / skills) under ~/.grok, all agent-owned.
# NO version pin (2026-07-28 policy: latest-at-build, always adapt — fleet-wide
# across grok/gemini/codex/kimi). Download the installer to a file first (a
# `curl | bash` pipe hides a curl failure as a silent no-op) and verify the
# binary installed AND runs, so a broken install fails the build here, not at
# spawn; the resolved version is stamped to /etc/grok-cli-version (build-log +
# on-disk provenance, not a pin — the next build reinstalls whatever's latest).
RUN su agent -s /bin/bash -c "set -euo pipefail; export HOME=/home/agent; \
      curl -fsSL https://x.ai/cli/install.sh -o /tmp/grok-install.sh; \
      bash /tmp/grok-install.sh; \
      test -x /home/agent/.grok/bin/grok" \
    && rm -rf /tmp/* \
    # Provenance stamp runs as root (outside the su subshell — /etc is
    # root-writable only) with root's HOME; fine while `grok --version`
    # touches no $HOME-relative state.
    && /home/agent/.grok/bin/grok --version | tee /etc/grok-cli-version

# Entrypoint: render ~/.grok/config.toml + the per-role flags, then run grok
# headless (overrides the base image's `claude` entrypoint). ~/.grok is already
# agent:agent-owned (installed above via `su agent`), so no chown needed here.
COPY docker/scripts/grok-cli-agent-entrypoint.sh /app/scripts/grok-cli-agent-entrypoint.sh
RUN chmod 0755 /app/scripts/grok-cli-agent-entrypoint.sh

USER agent

# grok installs to ~/.grok/bin; put it ahead of the venv on PATH so the
# entrypoint finds `grok` (and still resolves `python` to /app/.venv/bin).
ENV PATH="/home/agent/.grok/bin:/app/.venv/bin:$PATH"

LABEL role="grok-cli-runtime"
LABEL description="Grok (xAI) agent runtime — Grok Build via the official grok CLI"
LABEL grok.cli.pinned="false"

ENTRYPOINT ["/app/scripts/grok-cli-agent-entrypoint.sh"]