Docker Agent is an AI agent building and running tool using YAML config, as a Docker CLI plugin. It supports multi-agent setups, rich tools, and various model providers.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
Docker Agent lets you create and run intelligent AI agents via a declarative YAML configuration, functioning as a Docker CLI plugin that can be run with docker agent. It supports multi-agent architectures, a rich tool ecosystem, and integration with MCP servers and various model providers. The README provides usage examples and installation methods.
How it works
Agents are defined in YAML with model, description, instruction, and toolsets. The tool ecosystem includes built-in tools and the MCP server. Agents can be run from an OCI registry or local YAML config using docker agent run or docker agent new to generate a configuration. The system supports running multiple agents that collaborate to solve tasks.
Getting started
Install options include:
"Docker Desktop" (4.63+) — docker-agent CLI plugin is pre-installed. Just run docker agent.
"Homebrew" — brew install docker-agent. Run docker-agent directly or symlink the binary to ~/.docker/cli-plugins/docker-agent and run docker agent.
"Binary releases" — Download from GitHub Releases. Symlink the docker-agent binary to ~/.docker/cli-plugins/docker-agent to be able to use docker agent, or use docker-agent directly.
Set at least one API key (or use Docker Model Runner) for local or cloud models:
export OPENAI_API_KEY=sk-... # or ANTHROPIC_API_KEY, GOOGLE_API_KEY, etc.
See the full setup guide for cloud vs local models.
Quick Start examples:
# Run the default agent
docker agent run
# Run from an OCI registry
docker agent run myorg/agent:tag
# Generate a new agent interactively
docker agent new
# Run your own config
docker agent run agent.yaml
More examples are available in the examples directory.
Recent releases
Latest release v1.121.0 on 2026-08-05 introduces configurable interrupt confirmation for the Esc key, ranged file reads, and improvements to safety classification and filesystem path handling. Prior release v1.120.0 (2026-08-03) added Windows compatibility improvements, new TUI features for context compaction and session plan editing, and fixes for sandbox issues. Earlier releases added features like first-class plan management with a new CLI command group and TUI browser, YAML safety mode defaults, and session isolation and credential security improvements. Also, a release added support for Claude Opus 5 and a new three-mode safety policy system for tool approval control.
Traction
The repository shows 3234 stars and 430 forks. There are 21 open issues.
Caveats
License is Apache-2.0. The project started in 2025-09-01 and was last pushed on 2026-08-04. The primary language is Go. Topics include agents and ai.