# tool-containers

> Container images for AI coding agents and the development shells they run in, published to GHCR and Docker Hub for developers and CI pipelines.

- [Documentation](https://tool-containers.hgh.dev/docs/): Catalog, Images and tags, How images are built

## AI

- [AI](https://tool-containers.hgh.dev/docs/ai/): Coding-agent CLIs, an agent meta-harness, and a web GUI for agents, built on the devbox and agentbloat images for Ubuntu and, mostly, Alpine.

### agentbloat

- [agentbloat](https://tool-containers.hgh.dev/docs/ai/agentbloat/): Codex, Claude Code, Cursor Agent, Gemini CLI, Copilot, and three more coding-agent CLIs in one interactive devbox shell, for Ubuntu or Alpine.
- [Run agentbloat with Docker](https://tool-containers.hgh.dev/docs/ai/agentbloat/docker/): Interactive multi-agent workspace
- [Run agentbloat with Docker Compose](https://tool-containers.hgh.dev/docs/ai/agentbloat/docker-compose/): Repeatable local multi-agent workspace
- [Run agentbloat with Podman](https://tool-containers.hgh.dev/docs/ai/agentbloat/podman/): Rootless multi-agent workstation
- [Run agentbloat with Kubernetes](https://tool-containers.hgh.dev/docs/ai/agentbloat/kubernetes/): Long-lived cluster workspace from plain manifests
- [Run agentbloat with Helm](https://tool-containers.hgh.dev/docs/ai/agentbloat/helm/): Long-lived cluster workspace from a Helm chart
- [Run agentbloat with Dev Container](https://tool-containers.hgh.dev/docs/ai/agentbloat/devcontainer/): Multi-agent workspace inside the editor

### Claude Code

- [Claude Code](https://tool-containers.hgh.dev/docs/ai/claude-code/): Anthropic's Claude Code CLI on the devbox development image, with Ubuntu and Alpine variants and optional headless Chromium.
- [Run Claude Code with Docker](https://tool-containers.hgh.dev/docs/ai/claude-code/docker/): Interactive coding on a local checkout
- [Run Claude Code with Docker Compose](https://tool-containers.hgh.dev/docs/ai/claude-code/docker-compose/): Repeatable local sessions
- [Run Claude Code with Podman](https://tool-containers.hgh.dev/docs/ai/claude-code/podman/): Rootless sessions on a workstation
- [Run Claude Code with Kubernetes](https://tool-containers.hgh.dev/docs/ai/claude-code/kubernetes/): One-shot review in a cluster from plain manifests
- [Run Claude Code with Helm](https://tool-containers.hgh.dev/docs/ai/claude-code/helm/): One-shot review in a cluster from a Helm chart
- [Run Claude Code with GitHub Actions](https://tool-containers.hgh.dev/docs/ai/claude-code/github-actions/): Code review in CI on GitHub pull requests
- [Run Claude Code with GitLab CI](https://tool-containers.hgh.dev/docs/ai/claude-code/gitlab-ci/): Code review in CI on GitLab merge requests

### Codex CLI

- [Codex CLI](https://tool-containers.hgh.dev/docs/ai/codex/): OpenAI Codex CLI on the devbox development image, with Ubuntu and Alpine variants and optional headless Chromium.
- [Run Codex CLI with Docker](https://tool-containers.hgh.dev/docs/ai/codex/docker/): Interactive coding on a local checkout
- [Run Codex CLI with Docker Compose](https://tool-containers.hgh.dev/docs/ai/codex/docker-compose/): Repeatable local sessions
- [Run Codex CLI with Podman](https://tool-containers.hgh.dev/docs/ai/codex/podman/): Rootless sessions on a workstation
- [Run Codex CLI with GitHub Actions](https://tool-containers.hgh.dev/docs/ai/codex/github-actions/): Code review in CI on GitHub pull requests
- [Run Codex CLI with GitLab CI](https://tool-containers.hgh.dev/docs/ai/codex/gitlab-ci/): Code review in CI on GitLab merge requests

### Omnigent

- [Omnigent](https://tool-containers.hgh.dev/docs/ai/omnigent/): Omnigent, the open-source meta-harness that runs Claude Code, Codex, Pi and other agents in one session, on the agentbloat image with every CLI.
- [Run Omnigent with Docker](https://tool-containers.hgh.dev/docs/ai/omnigent/docker/): Orchestrate agents over a local checkout
- [Run Omnigent with Docker Compose](https://tool-containers.hgh.dev/docs/ai/omnigent/docker-compose/): Repeatable local orchestration sessions
- [Run Omnigent with Podman](https://tool-containers.hgh.dev/docs/ai/omnigent/podman/): Rootless agent orchestration on a workstation

### Open Code Review

- [Open Code Review](https://tool-containers.hgh.dev/docs/ai/open-code-review/): Alibaba's Open Code Review CLI, ocr, which reviews Git changes with an LLM, on the devbox image for Ubuntu and Alpine, with or without a browser.
- [Run Open Code Review with Docker](https://tool-containers.hgh.dev/docs/ai/open-code-review/docker/): Review the current checkout
- [Run Open Code Review with Docker Compose](https://tool-containers.hgh.dev/docs/ai/open-code-review/docker-compose/): Repeatable local reviews
- [Run Open Code Review with Podman](https://tool-containers.hgh.dev/docs/ai/open-code-review/podman/): Rootless reviews on a workstation
- [Run Open Code Review with GitHub Actions](https://tool-containers.hgh.dev/docs/ai/open-code-review/github-actions/): Code review in CI on GitHub pull requests
- [Run Open Code Review with GitLab CI](https://tool-containers.hgh.dev/docs/ai/open-code-review/gitlab-ci/): Code review in CI on GitLab merge requests

### Pi Coding Agent

- [Pi Coding Agent](https://tool-containers.hgh.dev/docs/ai/pi-agent/): Pi, a minimal and extensible terminal coding agent, on the devbox image with Ubuntu and Alpine variants and optional Chromium.
- [Run Pi Coding Agent with Docker](https://tool-containers.hgh.dev/docs/ai/pi-agent/docker/): Interactive coding on a local checkout
- [Run Pi Coding Agent with Docker Compose](https://tool-containers.hgh.dev/docs/ai/pi-agent/docker-compose/): Repeatable local sessions
- [Run Pi Coding Agent with Podman](https://tool-containers.hgh.dev/docs/ai/pi-agent/podman/): Rootless sessions on a workstation
- [Run Pi Coding Agent with GitHub Actions](https://tool-containers.hgh.dev/docs/ai/pi-agent/github-actions/): Code review in CI on GitHub pull requests
- [Run Pi Coding Agent with GitLab CI](https://tool-containers.hgh.dev/docs/ai/pi-agent/gitlab-ci/): Code review in CI on GitLab merge requests

### T3 Code

- [T3 Code](https://tool-containers.hgh.dev/docs/ai/t3code/): T3 Code, a web GUI for Codex, Claude Code, and other coding agents, served on port 3773 from the agentbloat image with every agent CLI installed.
- [Run T3 Code with Docker](https://tool-containers.hgh.dev/docs/ai/t3code/docker/): Local GUI over a checkout
- [Run T3 Code with Docker Compose](https://tool-containers.hgh.dev/docs/ai/t3code/docker-compose/): Persistent local instance
- [Run T3 Code with Podman](https://tool-containers.hgh.dev/docs/ai/t3code/podman/): Rootless local instance
- [Run T3 Code with Kubernetes](https://tool-containers.hgh.dev/docs/ai/t3code/kubernetes/): Shared cluster instance from plain manifests
- [Run T3 Code with Helm](https://tool-containers.hgh.dev/docs/ai/t3code/helm/): Shared cluster instance from a Helm chart

## Base

- [Base](https://tool-containers.hgh.dev/docs/base/): Hardened minimal application bases and interactive development images on Wolfi, Alpine, and Ubuntu that the other images in the catalog build from.

### core

- [core](https://tool-containers.hgh.dev/docs/base/core/): Hardened minimal base images on Wolfi, Alpine, and Ubuntu with CA certificates, tzdata, curl, bash, and an unprivileged nonroot user.
- [Run core with Docker](https://tool-containers.hgh.dev/docs/base/core/docker/): Throwaway shell or base for your own image
- [Run core with Docker Compose](https://tool-containers.hgh.dev/docs/base/core/docker-compose/): Locked-down read-only shell service

### devbox

- [devbox](https://tool-containers.hgh.dev/docs/base/devbox/): Ubuntu and Alpine images for development shells and CI jobs, in lite, full, and browser tiers, with Zsh, sudo, and pinned toolchains.
- [Run devbox with Docker](https://tool-containers.hgh.dev/docs/base/devbox/docker/): Interactive development shell on a checkout
- [Run devbox with Docker Compose](https://tool-containers.hgh.dev/docs/base/devbox/docker-compose/): Reusable shell with a persistent home
- [Run devbox with Podman](https://tool-containers.hgh.dev/docs/base/devbox/podman/): Rootless development shell or Quadlet service
- [Run devbox with Kubernetes](https://tool-containers.hgh.dev/docs/base/devbox/kubernetes/): Disposable cluster development pod
- [Run devbox with Helm](https://tool-containers.hgh.dev/docs/base/devbox/helm/): Long-running cluster pod with a persistent workspace
- [Run devbox with GitHub Actions](https://tool-containers.hgh.dev/docs/base/devbox/github-actions/): CI job with the full toolchain on GitHub
- [Run devbox with GitLab CI](https://tool-containers.hgh.dev/docs/base/devbox/gitlab-ci/): CI job with the full toolchain on GitLab
- [Run devbox with Dev Container](https://tool-containers.hgh.dev/docs/base/devbox/devcontainer/): Editor-attached development container