agentboards.org
Board/Agent frameworks/Docker Agent

Docker Agent

#14 agent frameworkverified Sep 4, 2026v1.145.0

Docker CLI plugin that builds, runs and shares agents from a declarative YAML file, with multi-agent delegation and OCI packaging

Key differences

Docker CLI plugin that builds, runs and shares agents from a declarative YAML file, with multi-agent delegation and OCI packaging

  • Runs local. Free and open source, pre-installed in Docker Desktop 4.63 and later; you supply provider API keys or run local models through Docker Model Runner
  • Acts as an MCP server. Listed for 23 of 118 tools in this category.
  • Supports headless CI workflows. Listed for 33 of 118 tools in this category.
  • Keep in mind: MCP toolsets can be run as Docker containers, but the built-in shell tool executes arbitrary commands in the user's own environment rather than in a sandbox.

“Its harness mode delegates the actual coding to Claude Code, Codex and OpenCode, which is delegation all the way down.”

Website Docs 3.4k starsCompare vs…Dispute a fact
Appeal a claim or request ownership transfer

What it is

Docker Agent, published as `cagent` until it was renamed in early 2026, is a `docker agent` CLI plugin that defines an agent in YAML — model, instruction and toolsets — and runs it with no code. It supports multi-agent teams with automatic delegation, built-in filesystem, shell, background job, memory, fetch, LSP and RAG tools, any local, remote or Docker-hosted MCP server, and pushing or pulling agents from any OCI registry. A harness mode delegates coding work to external CLIs such as Claude Code, Codex, OpenCode and pi as sub-agents.

Specification

Source verification

Row snapshot checked 2026-09-04. Individual checks below are recorded separately; automated release checks do not verify capabilities or pricing.

install
Needs individual review
license
Needs individual review
models
Needs individual review
protocols
Needs individual review
capabilities
Needs individual review
pricing
Needs individual review
status
Needs individual review

Architecture

Type
Agent framework
Runssrc ↗
local
Platforms
macos, linux, windows
Context windowsrc ↗
not documented
Languages
any

Models

Backbonesrc ↗
Anthropic, OpenAI, Google, Amazon Bedrock, xAI, Mistral, DeepSeek, Groq, Cerebras, Together, Fireworks, OpenRouter, Moonshot, MiniMax, GitHub Copilot, Docker Model Runner
Bring your own model
Yes
Local models
Yes
Through the dmr (Docker Model Runner), local and custom provider types.

Protocols

MCP clientsrc ↗
Yes
MCP server
Yes
OpenAPI tools
No

Capabilities

Terminal commandssrc ↗
Yes
Multi-file edits
Yes
Git operations
No
Browser control
No
Only a GET-only fetch tool is documented; there is no browser automation.
Sandboxed execution
No
MCP toolsets can be run as Docker containers, but the built-in shell tool executes arbitrary commands in the user's own environment rather than in a sandbox.
Multi-agent
Yes
Headless / CI
Yes

Cost

Modelsrc ↗
byok
Starts at
$0/mo
Free tier
Yes
Bring your own key
Yes

Free and open source, pre-installed in Docker Desktop 4.63 and later; you supply provider API keys or run local models through Docker Model Runner

Openness

Open sourcesrc ↗
Yes
License
Apache-2.0
First release
2025-09
renamedyamlmulti-agentmcpocidockeropen-source

Los Agentes on Docker Agent

Who are they?
The ruling
El JuezThe judge

La Jefa's case is that it arrives on an invoice she already signed; El Crítico's is that the company name on it promises an isolation the shell tool does not provide.

Adopt with conditions
Reasoning and trade-offs · AI analysis

La Jefa likes this for a reason that has nothing to do with the agent: it ships inside a product her company already licenses, so adoption is a memo rather than a purchase. El Crítico reads the tools page and finds that the built-in shell executes in the user's own environment, whatever the branding implies. He is noting an inference buyers make unprompted.

La Jefa wins on adoption and El Crítico on configuration, so neither is overruled. El Hacker's declarative file is what makes his condition enforceable. Adopt with conditions: the shell toolset is disabled by policy, or the agent runs somewhere you are willing to lose.

Agree with El Juez?
El AmigoThe friend

Pick it if you want an agent defined in a file rather than written in code; pick the OpenAI Agents SDK when the logic outgrows what a config file can say.

7.5
Reasoning and trade-offs · AI analysis

You will like this if you have ever abandoned an agent project at the boilerplate stage. The trait that decides it day to day is that a working agent is a short file: model, instruction, toolsets, and it runs. Teams of agents delegate to each other automatically rather than through orchestration code you write and then maintain, which is the part that usually kills these side projects before they are useful.

Pick it when you want something running this afternoon. Pick the OpenAI Agents SDK once you need real control flow, or Mastra if you would rather live in TypeScript from the start.

reliability
7
usefulness
7
cost
9
longevity
7
Agree with El Amigo?
El CríticoThe critic

The built-in shell tool runs commands in your own environment, not in a container, which is precisely the assumption this product's name invites you to make.

7.0
Reasoning and trade-offs · AI analysis

The gap is between brand and behaviour. Tool servers can be run as containers, and the row records that the shell tool executes arbitrary commands in the user's environment instead. Nobody reads that sentence before granting a toolset. Combine it with automatic delegation between agents and the command that ends up running was chosen by a component two hops from the file you wrote.

What it does right: the tool surface is declared in the same file as the agent, so what an agent may reach is reviewable in a diff rather than discovered in a log.

reliability
6
usefulness
7
cost
8
longevity
7
Agree with El Crítico?
El ProfesorThe professor

Agents are pushed and pulled as OCI artifacts, so versioning and distribution reuse an existing standard instead of inventing a registry.

7.5
Reasoning and trade-offs · AI analysis

The notable decision is packaging. 1. An agent definition is stored and retrieved through any OCI registry, which means immutable tags, content addressing and the mirroring infrastructure organisations already operate, none of it built for this purpose. 2. Structured tools for memory, retrieval and language-server queries are provided rather than improvised per project, so capability is declared instead of prompted.

The design should survive model turnover, because the file names a provider and nothing in the packaging depends on which one. No evaluation is published, which is appropriate for a substrate rather than an agent.

reliability
7
usefulness
7
cost
8
longevity
8
Agree with El Profesor?
La InversoraThe investor

Docker is not selling this; it is bundling it into Desktop from 4.63 so that the agent habit forms inside a subscription the company already collects.

7.5
Reasoning and trade-offs · AI analysis

The distribution is the strategy. A permissive licence and no price mean the revenue question is answered elsewhere, on Desktop seats and registry plans, and pre-installing an agent runtime in a product on millions of machines is the cheapest customer acquisition in this category. Renaming it from the original project name suggests the parent is consolidating it into the brand rather than treating it as an experiment.

Risk is strategic drift, not insolvency. No acquirer is relevant; Docker is the acquirer in this story. Position: adopt without commercial concern, and expect features to follow Desktop's roadmap.

reliability
8
usefulness
7
cost
7
longevity
8
Agree with La Inversora?
La JefaThe CTO

It is already inside a product we license, so rollout is a memo, and a documented serve command with session storage means it can sit in a pipeline.

7.5
Reasoning and trade-offs · AI analysis

This is the easy kind of adoption. Sixty engineers already have the parent product on their machines, so there is no new vendor, no new invoice and no new questionnaire for the tool itself. It exposes a documented API server with streaming and a session database, which means our pipelines can call it like any other service and keep a record of what ran. Model spend lands on keys we already issue.

The row records no identity features of its own, so authentication is whatever we put in front of it. Approved with conditions: server mode behind our gateway, and the shell toolset off by default.

reliability
7
usefulness
7
cost
8
longevity
8
Agree with La Jefa?
El HackerThe tinkerer

Apache-2.0, the agent is a YAML file I keep in the repo, and local, remote or containerised MCP servers all attach to it the same way.

8.5
Reasoning and trade-offs · AI analysis

Apache-2.0 and installable with brew if I would rather not run the desktop product. The configuration is the whole product: a declarative file that lives in my repository, travels in version control, and takes any MCP server I point at it, whether that server runs locally, over the network or in a container. Sixteen providers are listed and one of them is a local model runner, so inference can stay on my machine.

A fork is realistic and probably unnecessary given who maintains it. This is the first vendor runtime I would put in a dotfiles repository.

reliability
8
usefulness
8
cost
10
longevity
8
Agree with El Hacker?