Merge pull request #2067 from dgageot/fix-broken-links

Fix broken links

Author: dgageot

docs/community/troubleshooting/index.md

@@ -195,7 +195,7 @@ In API server mode, each client gets isolated sessions. If sessions are mixing u
 
 - Check if MCP tools are adding latency (visible in debug logs)
 - Use the `/cost` command in TUI to see token usage and identify expensive interactions
-- For DMR, consider enabling [speculative decoding](/providers/dmr/) for faster inference
+- For DMR, consider enabling [speculative decoding]({{ '/providers/dmr/' | relative_url }}) for faster inference
 
 ### Tool resource leaks
 
@@ -229,7 +229,7 @@ When reviewing debug logs, search for these key patterns:
 | `"Tool call"`               | A tool is being executed                                                   |
 | `"Tool call result"`        | Tool execution completed                                                   |
 | `"Stream stopped"`          | Agent finished processing                                                  |
-| `HTTP 429`                  | Rate limiting — consider adding a [fallback model](/configuration/agents/) |
+| `HTTP 429`                  | Rate limiting — consider adding a [fallback model]({{ '/configuration/agents/' | relative_url }}) |
 | `context canceled`          | Operation was interrupted (timeout or user cancel)                         |
 | `[RAG Manager]`             | RAG retrieval operations                                                   |
 | `[Reranker]`                | Reranking operations                                                       |

docs/concepts/agents/index.md

@@ -12,7 +12,7 @@ _Agents are the core building blocks of docker-agent. Each agent is an AI-powere
 
 An agent in docker-agent is defined by:
 
-- **Model** — The AI model powering it (e.g., Claude, GPT-4o, Gemini). See [Models](/concepts/models/).
+- **Model** — The AI model powering it (e.g., Claude, GPT-4o, Gemini). See [Models]({{ '/concepts/models/' | relative_url }}).
 - **Description** — A brief summary of what the agent does (used by other agents for delegation)
 - **Instruction** — The system prompt that defines the agent's behavior and personality
 - **Tools** — Capabilities like filesystem access, shell commands, or external APIs

docs/concepts/models/index.md

@@ -55,7 +55,7 @@ Named models let you configure temperature, token limits, thinking budgets, and
 | Mistral             | `mistral`        | Mistral models                       | `MISTRAL_API_KEY`   |
 | xAI                 | `xai`            | Grok models                          | `XAI_API_KEY`       |
 
-See the [Model Providers](/providers/overview/) section for detailed configuration guides.
+See the [Model Providers]({{ '/providers/overview/' | relative_url }}) section for detailed configuration guides.
 
 ## Model Properties
 

docs/concepts/tools/index.md

@@ -29,39 +29,39 @@ docker-agent ships with several built-in tools that require no external dependen
 
 | Tool | Description |
 | --- | --- |
-| [Filesystem](/tools/filesystem/) | Read, write, list, search, and navigate files and directories |
-| [Shell](/tools/shell/) | Execute arbitrary shell commands in the user's environment |
-| [Think](/tools/think/) | Step-by-step reasoning scratchpad for planning and decision-making |
-| [Todo](/tools/todo/) | Task list management for complex multi-step workflows |
-| [Memory](/tools/memory/) | Persistent key-value storage backed by SQLite |
-| [Fetch](/tools/fetch/) | Make HTTP requests to external APIs and web services |
-| [Script](/tools/script/) | Define custom shell scripts as named tools |
-| [LSP](/tools/lsp/) | Connect to Language Server Protocol servers for code intelligence |
-| [API](/tools/api/) | Create custom tools that call HTTP APIs without writing code |
-| [User Prompt](/tools/user-prompt/) | Ask users questions and collect interactive input |
-| [Transfer Task](/tools/transfer-task/) | Delegate tasks to sub-agents (auto-enabled with `sub_agents`) |
-| [Background Agents](/tools/background-agents/) | Dispatch work to sub-agents concurrently |
-| [Handoff](/tools/handoff/) | Delegate tasks to remote agents via A2A |
-| [A2A](/tools/a2a/) | Connect to remote agents via the Agent-to-Agent protocol |
+| [Filesystem]({{ '/tools/filesystem/' | relative_url }}) | Read, write, list, search, and navigate files and directories |
+| [Shell]({{ '/tools/shell/' | relative_url }}) | Execute arbitrary shell commands in the user's environment |
+| [Think]({{ '/tools/think/' | relative_url }}) | Step-by-step reasoning scratchpad for planning and decision-making |
+| [Todo]({{ '/tools/todo/' | relative_url }}) | Task list management for complex multi-step workflows |
+| [Memory]({{ '/tools/memory/' | relative_url }}) | Persistent key-value storage backed by SQLite |
+| [Fetch]({{ '/tools/fetch/' | relative_url }}) | Make HTTP requests to external APIs and web services |
+| [Script]({{ '/tools/script/' | relative_url }}) | Define custom shell scripts as named tools |
+| [LSP]({{ '/tools/lsp/' | relative_url }}) | Connect to Language Server Protocol servers for code intelligence |
+| [API]({{ '/tools/api/' | relative_url }}) | Create custom tools that call HTTP APIs without writing code |
+| [User Prompt]({{ '/tools/user-prompt/' | relative_url }}) | Ask users questions and collect interactive input |
+| [Transfer Task]({{ '/tools/transfer-task/' | relative_url }}) | Delegate tasks to sub-agents (auto-enabled with `sub_agents`) |
+| [Background Agents]({{ '/tools/background-agents/' | relative_url }}) | Dispatch work to sub-agents concurrently |
+| [Handoff]({{ '/tools/handoff/' | relative_url }}) | Delegate tasks to remote agents via A2A |
+| [A2A]({{ '/tools/a2a/' | relative_url }}) | Connect to remote agents via the Agent-to-Agent protocol |
 
 ## MCP Tools
 
 docker-agent supports the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) for extending agents with external tools. There are three ways to connect MCP tools:
 
 - **Docker MCP** (recommended) — Run MCP servers in Docker containers via the [MCP Gateway](https://github.com/docker/mcp-gateway). Browse the [Docker MCP Catalog](https://hub.docker.com/search?q=&type=mcp).
 - **Local MCP (stdio)** — Run MCP servers as local processes communicating over stdin/stdout.
-- **Remote MCP (SSE / HTTP)** — Connect to MCP servers running on a network. See [Remote MCP Servers](/features/remote-mcp/).
+- **Remote MCP (SSE / HTTP)** — Connect to MCP servers running on a network. See [Remote MCP Servers]({{ '/features/remote-mcp/' | relative_url }}).
 
 ```yaml
 toolsets:
   - type: mcp
     ref: docker:duckduckgo
 ```
 
-See [Tool Config](/configuration/tools/#mcp-tools) for full MCP configuration reference.
+See [Tool Config]({{ '/configuration/tools/#mcp-tools' | relative_url }}) for full MCP configuration reference.
 
 <div class="callout callout-tip">
 <div class="callout-title">💡 See also
 </div>
-  <p>For full configuration reference, see <a href="/configuration/tools/">Tool Config</a>. For RAG (document retrieval), see <a href="/features/rag/">RAG</a>.</p>
+  <p>For full configuration reference, see <a href="{{ '/configuration/tools/' | relative_url }}">Tool Config</a>. For RAG (document retrieval), see <a href="{{ '/features/rag/' | relative_url }}">RAG</a>.</p>
 </div>

docs/configuration/agents/index.md

@@ -62,7 +62,7 @@ agents:
 | `description`               | string  | ✓        | Brief description of the agent's purpose. Used by coordinators to decide delegation.                                                                                          |
 | `instruction`               | string  | ✓        | System prompt that defines the agent's behavior, personality, and constraints.                                                                                                |
 | `sub_agents`                | array   | ✗        | List of agent names this agent can delegate to. Automatically enables the `transfer_task` tool.                                                                               |
-| `toolsets`                  | array   | ✗        | List of tool configurations. See [Tool Config](/configuration/tools/).                                                                                                        |
+| `toolsets`                  | array   | ✗        | List of tool configurations. See [Tool Config]({{ '/configuration/tools/' | relative_url }}).                                                                                                        |
 | `fallback`                  | object  | ✗        | Automatic model failover configuration.                                                                                                                                       |
 | `add_date`                  | boolean | ✗        | When `true`, injects the current date into the agent's context.                                                                                                               |
 | `add_environment_info`      | boolean | ✗        | When `true`, injects working directory, OS, CPU architecture, and git info into context.                                                                                      |
@@ -71,13 +71,13 @@ agents:
 | `code_mode_tools`           | boolean | ✗        | When `true`, formats tool responses in a code-optimized format with structured output schemas. Useful for MCP gateway and programmatic access.                                |
 | `max_iterations`            | int     | ✗        | Maximum number of tool-calling loops. Default: unlimited (0). Set this to prevent infinite loops.                                                                             |
 | `num_history_items`         | int     | ✗        | Limit the number of conversation history messages sent to the model. Useful for managing context window size with long conversations. Default: unlimited (all messages sent). |
-| `rag`                       | array   | ✗        | List of RAG source names to attach to this agent. References sources defined in the top-level `rag` section. See [RAG](/features/rag/).                                       |
+| `rag`                       | array   | ✗        | List of RAG source names to attach to this agent. References sources defined in the top-level `rag` section. See [RAG]({{ '/features/rag/' | relative_url }}).                                       |
 | `skills`                    | boolean | ✗        | Enable automatic skill discovery from standard directories.                                                                                                                   |
 | `commands`                  | object  | ✗        | Named prompts that can be run with `docker agent run config.yaml /command_name`.                                                                                              |
 | `welcome_message`           | string  | ✗        | Message displayed to the user when a session starts. Useful for providing context or instructions.                                                                            |
-| `handoffs`                  | array   | ✗        | List of A2A agent configurations this agent can delegate to. See [A2A Protocol](/features/a2a/).                                                                              |
-| `hooks`                     | object  | ✗        | Lifecycle hooks for running commands at various points. See [Hooks](/configuration/hooks/).                                                                                   |
-| `structured_output`         | object  | ✗        | Constrain agent output to match a JSON schema. See [Structured Output](/configuration/structured-output/).                                                                    |
+| `handoffs`                  | array   | ✗        | List of A2A agent configurations this agent can delegate to. See [A2A Protocol]({{ '/features/a2a/' | relative_url }}).                                                                              |
+| `hooks`                     | object  | ✗        | Lifecycle hooks for running commands at various points. See [Hooks]({{ '/configuration/hooks/' | relative_url }}).                                                                                   |
+| `structured_output`         | object  | ✗        | Constrain agent output to match a JSON schema. See [Structured Output]({{ '/configuration/structured-output/' | relative_url }}).                                                                    |
 
 <div class="callout callout-warning">
 <div class="callout-title">⚠️ max_iterations
@@ -109,7 +109,7 @@ agents:
 
 ## Deferred Tool Loading
 
-Toolsets support `defer` to load tools on-demand and speed up agent startup. See [Deferred Tool Loading](/configuration/tools/#deferred-tool-loading) for details.
+Toolsets support `defer` to load tools on-demand and speed up agent startup. See [Deferred Tool Loading]({{ '/configuration/tools/#deferred-tool-loading' | relative_url }}) for details.
 
 ```yaml
 agents:

docs/configuration/models/index.md

@@ -47,7 +47,7 @@ models:
 | `thinking_budget`     | string/int | ✗        | Reasoning effort control                                                              |
 | `parallel_tool_calls` | boolean    | ✗        | Allow model to call multiple tools at once                                            |
 | `track_usage`         | boolean    | ✗        | Track and report token usage for this model                                           |
-| `routing`             | array      | ✗        | Rule-based routing to different models. See [Model Routing](/configuration/routing/). |
+| `routing`             | array      | ✗        | Rule-based routing to different models. See [Model Routing]({{ '/configuration/routing/' | relative_url }}). |
 | `provider_opts`       | object     | ✗        | Provider-specific options (see provider pages)                                        |
 
 ## Thinking Budget
@@ -166,7 +166,7 @@ models:
     max_tokens: 8192
 ```
 
-For detailed provider setup, see the [Model Providers](/providers/overview/) section.
+For detailed provider setup, see the [Model Providers]({{ '/providers/overview/' | relative_url }}) section.
 
 ## Custom Endpoints
 
@@ -195,4 +195,4 @@ models:
     token_key: INTERNAL_API_KEY
 ```
 
-See [Local Models](/providers/local/) for more examples of custom endpoints.
+See [Local Models]({{ '/providers/local/' | relative_url }}) for more examples of custom endpoints.

docs/configuration/overview/index.md

@@ -215,7 +215,7 @@ metadata:
 | `readme`      | Longer markdown description                |
 | `version`     | Semantic version string                    |
 
-See [Agent Distribution](/concepts/distribution/) for publishing agents to registries.
+See [Agent Distribution]({{ '/concepts/distribution/' | relative_url }}) for publishing agents to registries.
 
 ## Custom Providers Section
 
@@ -249,4 +249,4 @@ agents:
 | `base_url`  | Base URL for the API endpoint                                        |
 | `token_key` | Environment variable name for the API token                          |
 
-See [Custom Providers](/providers/custom/) for more details.
+See [Custom Providers]({{ '/providers/custom/' | relative_url }}) for more details.

docs/configuration/permissions/index.md

@@ -180,7 +180,7 @@ permissions:
 
 ## Combining with Hooks
 
-Permissions work alongside [hooks](/configuration/hooks/). The evaluation order is:
+Permissions work alongside [hooks]({{ '/configuration/hooks/' | relative_url }}). The evaluation order is:
 
 1. Check **deny** patterns — if matched, tool is blocked
 2. Check **allow** patterns — if matched, tool is auto-approved

docs/configuration/tools/index.md

@@ -14,20 +14,20 @@ Built-in tools are included with docker-agent and require no external dependenci
 
 | Type | Description | Page |
 | --- | --- | --- |
-| `filesystem` | Read, write, list, search, navigate | [Filesystem](/tools/filesystem/) |
-| `shell` | Execute shell commands | [Shell](/tools/shell/) |
-| `think` | Reasoning scratchpad | [Think](/tools/think/) |
-| `todo` | Task list management | [Todo](/tools/todo/) |
-| `memory` | Persistent key-value storage (SQLite) | [Memory](/tools/memory/) |
-| `fetch` | HTTP requests | [Fetch](/tools/fetch/) |
-| `script` | Custom shell scripts as tools | [Script](/tools/script/) |
-| `lsp` | Language Server Protocol integration | [LSP](/tools/lsp/) |
-| `api` | Custom HTTP API tools | [API](/tools/api/) |
-| `user_prompt` | Interactive user input | [User Prompt](/tools/user-prompt/) |
-| `transfer_task` | Delegate to sub-agents (auto-enabled) | [Transfer Task](/tools/transfer-task/) |
-| `background_agents` | Parallel sub-agent dispatch | [Background Agents](/tools/background-agents/) |
-| `handoff` | A2A remote agent delegation | [Handoff](/tools/handoff/) |
-| `a2a` | A2A remote agent connection | [A2A](/tools/a2a/) |
+| `filesystem` | Read, write, list, search, navigate | [Filesystem]({{ '/tools/filesystem/' | relative_url }}) |
+| `shell` | Execute shell commands | [Shell]({{ '/tools/shell/' | relative_url }}) |
+| `think` | Reasoning scratchpad | [Think]({{ '/tools/think/' | relative_url }}) |
+| `todo` | Task list management | [Todo]({{ '/tools/todo/' | relative_url }}) |
+| `memory` | Persistent key-value storage (SQLite) | [Memory]({{ '/tools/memory/' | relative_url }}) |
+| `fetch` | HTTP requests | [Fetch]({{ '/tools/fetch/' | relative_url }}) |
+| `script` | Custom shell scripts as tools | [Script]({{ '/tools/script/' | relative_url }}) |
+| `lsp` | Language Server Protocol integration | [LSP]({{ '/tools/lsp/' | relative_url }}) |
+| `api` | Custom HTTP API tools | [API]({{ '/tools/api/' | relative_url }}) |
+| `user_prompt` | Interactive user input | [User Prompt]({{ '/tools/user-prompt/' | relative_url }}) |
+| `transfer_task` | Delegate to sub-agents (auto-enabled) | [Transfer Task]({{ '/tools/transfer-task/' | relative_url }}) |
+| `background_agents` | Parallel sub-agent dispatch | [Background Agents]({{ '/tools/background-agents/' | relative_url }}) |
+| `handoff` | A2A remote agent delegation | [Handoff]({{ '/tools/handoff/' | relative_url }}) |
+| `a2a` | A2A remote agent connection | [A2A]({{ '/tools/a2a/' | relative_url }}) |
 
 **Example:**
 

docs/features/cli/index.md

@@ -108,7 +108,7 @@ $ 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.
+See [MCP Mode]({{ '/features/mcp-mode/' | relative_url }}) for detailed setup.
 
 ### `docker agent serve a2a`
 
@@ -133,7 +133,7 @@ $ docker agent serve acp [config] [flags]
 $ docker agent serve acp agent.yaml
 ```
 
-See [ACP](/features/acp/) for details on the Agent Client Protocol.
+See [ACP]({{ '/features/acp/' | relative_url }}) for details on the Agent Client Protocol.
 
 ### `docker agent share push` / `docker agent share pull`
 
@@ -147,7 +147,7 @@ $ docker agent share push ./agent.yaml docker.io/username/my-agent:latest
 $ docker agent share pull docker.io/username/my-agent:latest
 ```
 
-See [Agent Distribution](/concepts/distribution/) for full registry workflow details.
+See [Agent Distribution]({{ '/concepts/distribution/' | relative_url }}) for full registry workflow details.
 
 ### `docker agent eval`