Merge pull request #1928 from gtardif/more_docs_rename

dgageot · web-flow · commit 8f2e177b9027 · 2026-03-04T18:03:21.000+01:00
More docs rename (in / docs), fix remaining `docker agent serve a2a/acp/mcp`
diff --git a/docs/TODO.md b/docs/TODO.md
@@ -2,7 +2,7 @@
 
 ## New Pages
 
-- [x] **Go SDK** — Not documented anywhere. The `examples/golibrary/` directory shows how to use cagent as a Go library. Needs a dedicated page. *(Completed: pages/guides/go-sdk.html)*
+- [x] **Go SDK** — Not documented anywhere. The `examples/golibrary/` directory shows how to use Docker Agent as a Go library. Needs a dedicated page. *(Completed: pages/guides/go-sdk.html)*
 - [x] **Hooks** — `hooks` agent config (`pre_tool_use`, `post_tool_use`, `session_start`, `session_end`, `on_user_input`) is a significant feature with no documentation page. Covers running shell commands at various agent lifecycle points. *(Completed: pages/configuration/hooks.html)*
 - [x] **Permissions** — Top-level `permissions` config with `allow`/`deny` glob patterns for tool call approval. Mentioned briefly in TUI page but has no dedicated reference. *(Completed: pages/configuration/permissions.html)*
 - [x] **Sandbox Mode** — Shell tool `sandbox` config runs commands in Docker containers. Includes `image` and `paths` (bind mounts with `:ro` support). Not documented. *(Completed: pages/configuration/sandbox.html)*
diff --git a/docs/_config.yml b/docs/_config.yml
@@ -1,4 +1,4 @@
-title: cagent
+title: Docker Agent
 description: Build, run, and share powerful AI agents with a declarative YAML config, rich tool ecosystem, and multi-agent orchestration — by Docker.
 url: "https://docker.github.io"
 baseurl: "/cagent"
diff --git a/docs/_includes/header.html b/docs/_includes/header.html
@@ -1,7 +1,7 @@
 <!-- Header -->
 <header class="header" role="banner">
   <div class="header-inner">
-    <a href="{{ '/' | relative_url }}" class="header-logo" aria-label="cagent docs home">
+    <a href="{{ '/' | relative_url }}" class="header-logo" aria-label="docker agent docs home">
       <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
         <rect x="3" y="11" width="18" height="10" rx="2"/>
         <circle cx="9" cy="16" r="1.5" fill="currentColor"/>
@@ -10,7 +10,7 @@
         <path d="M5 11V9"/>
         <path d="M19 11V9"/>
       </svg>
-      <span>cagent <span style="font-weight:400;color:var(--text-muted);font-size:0.85rem;">docs</span></span>
+      <span>Docker Agent <span style="font-weight:400;color:var(--text-muted);font-size:0.85rem;">docs</span></span>
     </a>
 
     <div class="header-actions">
@@ -23,7 +23,7 @@
         <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" aria-hidden="true"><path d="M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79z"/></svg>
       </button>
 
-      <a href="https://github.com/docker/cagent" target="_blank" rel="noopener" class="github-link" title="GitHub" aria-label="View cagent on GitHub">
+      <a href="https://github.com/docker/cagent" target="_blank" rel="noopener" class="github-link" title="GitHub" aria-label="View Docker Agent on GitHub">
         <svg viewBox="0 0 24 24" fill="currentColor" aria-hidden="true"><path d="M12 0C5.37 0 0 5.37 0 12c0 5.31 3.435 9.795 8.205 11.385.6.105.825-.255.825-.57 0-.285-.015-1.23-.015-2.235-3.015.555-3.795-.735-4.035-1.41-.135-.345-.72-1.41-1.23-1.695-.42-.225-1.02-.78-.015-.795.945-.015 1.62.87 1.845 1.23 1.08 1.815 2.805 1.305 3.495.99.105-.78.42-1.305.765-1.605-2.67-.3-5.46-1.335-5.46-5.925 0-1.305.465-2.385 1.23-3.225-.12-.3-.54-1.53.12-3.18 0 0 1.005-.315 3.3 1.23.96-.27 1.98-.405 3-.405s2.04.135 3 .405c2.295-1.56 3.3-1.23 3.3-1.23.66 1.65.24 2.88.12 3.18.765.84 1.23 1.905 1.23 3.225 0 4.605-2.805 5.625-5.475 5.925.435.375.81 1.095.81 2.22 0 1.605-.015 2.895-.015 3.3 0 .315.225.69.825.57A12.02 12.02 0 0 0 24 12c0-6.63-5.37-12-12-12z"/></svg>
       </a>
     </div>
diff --git a/docs/_layouts/default.html b/docs/_layouts/default.html
@@ -3,10 +3,10 @@
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>{% if page.title %}{{ page.title }} – cagent docs{% else %}cagent – Documentation{% endif %}</title>
+  <title>{% if page.title %}{{ page.title }} – Docker Agent docs{% else %}Docker Agent – Documentation{% endif %}</title>
   <meta name="description" content="{{ page.description | default: site.description }}">
 
-  <meta property="og:title" content="{% if page.title %}{{ page.title }} – cagent docs{% else %}cagent – Documentation{% endif %}">
+  <meta property="og:title" content="{% if page.title %}{{ page.title }} – Docker Agent docs{% else %}Docker Agent – Documentation{% endif %}">
   <meta property="og:description" content="{{ page.description | default: site.description }}">
   <meta property="og:type" content="{% if page.url == '/' %}website{% else %}article{% endif %}">
   <meta property="og:url" content="{{ page.url | absolute_url }}">
diff --git a/docs/configuration/overview/index.md b/docs/configuration/overview/index.md
@@ -165,7 +165,7 @@ docker-agent validates your configuration at startup:
 
 ## JSON Schema
 
-For editor autocompletion and validation, use the [cagent JSON Schema](https://github.com/docker/cagent/blob/main/agent-schema.json). Add this to the top of your YAML file:
+For editor autocompletion and validation, use the [Docker Agent JSON Schema](https://github.com/docker/cagent/blob/main/agent-schema.json). Add this to the top of your YAML file:
 
 ```bash
 # yaml-language-server: $schema=https://raw.githubusercontent.com/docker/docker-agent/main/agent-schema.json
diff --git a/docs/features/a2a/index.md b/docs/features/a2a/index.md
@@ -10,7 +10,7 @@ _Expose docker-agent agents via Google's Agent-to-Agent (A2A) protocol for inter
 
 ## Overview
 
-The `docker agent serve a2a` command starts an A2A server that exposes your agents using the [A2A protocol](https://google.github.io/A2A/). This enables communication between cagent and other agent frameworks that support A2A.
+The `docker agent serve a2a` command starts an A2A server that exposes your agents using the [A2A protocol](https://google.github.io/A2A/). This enables communication between Docker Agent and other agent frameworks that support A2A.
 
 <div class="callout callout-warning">
 <div class="callout-title">⚠️ Early support
diff --git a/docs/features/acp/index.md b/docs/features/acp/index.md
@@ -25,16 +25,16 @@ ACP is built on the [ACP Go SDK](https://github.com/coder/acp-go-sdk) and provid
 
 ```bash
 # Start ACP server on stdio
-$ docker agent acp ./agent.yaml
+$ docker agent serve acp ./agent.yaml
 
 # With a multi-agent team config
-$ docker agent acp ./team.yaml
+$ docker agent serve acp ./team.yaml
 
 # From the agent catalog
-$ docker agent acp agentcatalog/pirate
+$ docker agent serve acp agentcatalog/pirate
 
 # With a custom session database
-$ docker agent acp ./agent.yaml --session-db ./my-sessions.db
+$ docker agent serve acp ./agent.yaml --session-db ./my-sessions.db
 ```
 
 ## How It Works
diff --git a/docs/features/cli/index.md b/docs/features/cli/index.md
@@ -102,12 +102,12 @@ $ docker agent api ociReference --pull-interval 10  # auto-refresh
 Expose agents as MCP tools for use in Claude Desktop, Claude Code, or other MCP clients.
 
 ```bash
-$ docker agent mcp [config] [flags]
+$ docker agent serve mcp [config] [flags]
 
 # Examples
-$ docker agent mcp agent.yaml
-$ docker agent mcp agent.yaml --working-dir /path/to/project
-$ docker agent mcp agentcatalog/coder
+$ docker agent serve mcp agent.yaml
+$ docker agent serve mcp agent.yaml --working-dir /path/to/project
+$ docker agent serve mcp agentcatalog/coder
 ```
 
 See [MCP Mode](/features/mcp-mode/) for detailed setup.
@@ -214,9 +214,9 @@ Run an alias with: docker agent run <alias>
 <div class="callout callout-tip">
 <div class="callout-title">💡 Set a default agent
 </div>
-  <p>Create a <code>default</code> alias to customize what <code>cagent</code> starts with no arguments:</p>
-  <pre><code>$ cagent alias add default /my/default/agent.yaml</code></pre>
-  <p>Then simply run <code>cagent</code> — it will launch that agent automatically.</p>
+  <p>Create a <code>default</code> alias to customize what <code>docker agent</code> starts with no arguments:</p>
+  <pre><code>$ docker agent alias add default /my/default/agent.yaml</code></pre>
+  <p>Then simply run <code>docker agent</code> — it will launch that agent automatically.</p>
 
 </div>
 
diff --git a/docs/features/mcp-mode/index.md b/docs/features/mcp-mode/index.md
@@ -28,13 +28,13 @@ The `docker agent serve mcp` command makes your agents available to any applicat
 
 ```bash
 # Expose a local config
-$ docker agent mcp ./agent.yaml
+$ docker agent serve mcp ./agent.yaml
 
 # Expose from a registry
-$ docker agent mcp agentcatalog/pirate
+$ docker agent serve mcp agentcatalog/pirate
 
 # Set the working directory
-$ docker agent mcp ./agent.yaml --working-dir /path/to/project
+$ docker agent serve mcp ./agent.yaml --working-dir /path/to/project
 ```
 
 ## Using with Claude Desktop
@@ -73,7 +73,7 @@ Restart Claude Desktop after updating the configuration.
 $ claude mcp add --transport stdio myagent \
   --env OPENAI_API_KEY=$OPENAI_API_KEY \
   --env ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY \
-  -- docker agent mcp agentcatalog/pirate --working-dir $(pwd)
+  -- docker agent serve mcp agentcatalog/pirate --working-dir $(pwd)
 ```
 
 ## Multi-Agent in MCP Mode
diff --git a/docs/features/remote-mcp/index.md b/docs/features/remote-mcp/index.md
@@ -10,7 +10,7 @@ _Connect docker-agent to cloud services via remote MCP servers with built-in OAu
 
 ## Overview
 
-cagent supports connecting to remote MCP servers over **SSE** (Server-Sent Events) and **Streamable HTTP** transports. Many popular services offer MCP endpoints with OAuth — docker-agent handles the authentication flow automatically.
+Docker Agent supports connecting to remote MCP servers over **SSE** (Server-Sent Events) and **Streamable HTTP** transports. Many popular services offer MCP endpoints with OAuth — docker-agent handles the authentication flow automatically.
 
 ```yaml
 toolsets:

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-title: cagent`
	`1`	`+title: Docker Agent`
`2`	`2`	`description: Build, run, and share powerful AI agents with a declarative YAML config, rich tool ecosystem, and multi-agent orchestration — by Docker.`
`3`	`3`	`url: "https://docker.github.io"`
`4`	`4`	`baseurl: "/cagent"`