Skip to content

Rename cagent to Docker agent#24268

Open
gtardif wants to merge 4 commits intodocker:mainfrom
gtardif:cagent_rename
Open

Rename cagent to Docker agent#24268
gtardif wants to merge 4 commits intodocker:mainfrom
gtardif:cagent_rename

Conversation

@gtardif
Copy link
Contributor

@gtardif gtardif commented Mar 4, 2026

Description

cagent is now docker-agent, available as a standalone command of a docker CLI plugin (by default installed with Desktop since 4.63)

Reviews

  • Technical review
  • Editorial review
  • Product review

@netlify
Copy link

netlify bot commented Mar 4, 2026

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit f056741
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/69a8517547d18d0008d49c4a
😎 Deploy Preview https://deploy-preview-24268--docsdocker.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@github-actions github-actions bot added area/desktop Issue affects a desktop edition of Docker. E.g docker for mac area/get-started Relates to get started and onboarding docs area/guides area/ai labels Mar 4, 2026
Copy link
Contributor

@docker-agent docker-agent bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review Summary

Assessment: 🟢 APPROVE

This PR successfully renames "cagent" to "Docker Agent" across 30 documentation files. The changes are comprehensive and well-executed. I found 2 minor issues that could be improved, but they don't block the PR:

  1. Typo: "Alternativey" should be "Alternatively"
  2. Version clarity: The version information could be clearer about when the name change takes effect

Both are minor wording improvements.

Findings

Minor Issues

Typo in installation instructions

  • File: content/manuals/ai/docker-agent/_index.md:76
  • Severity: Low
  • Issue: The word "Alternativey" should be "Alternatively"

Version information could be clearer

  • File: content/manuals/ai/docker-agent/_index.md:64-65
  • Severity: Low
  • Issue: The text states "Docker Agent is included in Docker Desktop 4.63 and later" then "cagent is included in Docker Desktop 4.49 and later." Consider clarifying that versions 4.49-4.62 included cagent (the old name) and 4.63+ includes Docker Agent (the renamed version).

CLI plugin vs standalone binary usage

  • File: content/manuals/ai/docker-agent/integrations/mcp.md:96
  • Severity: Low
  • Issue: The example shows using the docker binary with CLI plugin approach, but the description mentions "path to docker-agent if not using the docker CLI plugin" which could be clearer about when to use which approach.

✅ No vendored or generated files were modified
✅ Proper aliases added for moved pages
✅ No broken links or command errors detected
✅ Markdown formatting is correct


Before configuring MCP integration, you need:

- **cagent installed** - See the [installation guide](../_index.md#installation)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This still says cagent

"mcpServers": {
"myagent": {
"command": "/usr/local/bin/cagent",
"command": "/usr/local/bin/docker",
Copy link
Contributor

@dvdksn dvdksn Mar 4, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For DD users, this is a symlink (on macos, to /Applications/Docker.app/Contents/Resources/bin/docker). Will it still work? For docker-ce users, the cli is usually installed to /usr/bin/docker (and I think for rootless it's under ~/.local/bin/docker)

should this point to the docker binary or the docker-agent binary?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

updated to just docker that should be in the path

releases](https://github.com/docker/cagent/releases)
- **From source**: See the [cagent
- **From source**: See the [Docker Agent
repository](https://github.com/docker/cagent?tab=readme-ov-file#build-from-source)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

a few more cagent mentions.

will the repo stay as docker/cagent?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For now, the cagent repo is still named cagent. Also, the homebrew formula and winget packages are not yet renamed, will update the docs later on that

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This file is auto-generated from the sandbox CLI plugin

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Removed that change for now, since the sandbox CLI still mentions cagent, will need to update (and regenerate) that part when sandbox has been updated

@gtardif gtardif force-pushed the cagent_rename branch 2 times, most recently from 8e38623 to c67b2c4 Compare March 4, 2026 15:31
gtardif added 4 commits March 4, 2026 16:36
Signed-off-by: Guillaume Tardif <guillaume.tardif@gmail.com>
Signed-off-by: Guillaume Tardif <guillaume.tardif@gmail.com>
…49, docker agent is available in desktop 4.63 and later

Signed-off-by: Guillaume Tardif <guillaume.tardif@gmail.com>
Signed-off-by: Guillaume Tardif <guillaume.tardif@gmail.com>
@gtardif gtardif requested a review from dvdksn March 4, 2026 15:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/ai area/desktop Issue affects a desktop edition of Docker. E.g docker for mac area/get-started Relates to get started and onboarding docs area/guides

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants