From 59553b8df84157243781e4840d15293c7bebb23a Mon Sep 17 00:00:00 2001
From: Matt Vollmer <matthewjvollmer@outlook.com>
Date: Mon, 16 Mar 2026 08:40:31 -0400
Subject: [PATCH] docs(ai-coder): add enablement instructions for agents
 experiment (#23057)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Adds a new **Enable Coder Agents** section to the Early Access doc
explaining how to activate the `agents` experiment flag via
`CODER_EXPERIMENTS` or `--experiments`.

## Changes

### `docs/ai-coder/agents/early-access.md`
- New **Enable Coder Agents** section with env var and CLI flag
examples.
- Note that the `agents` flag is excluded from wildcard (`*`) opt-in.
- Quick-start checklist: dashboard → Admin → configure provider/model →
start chatting.
- Link to GitHub issues for feedback.

### `docs/ai-coder/agents/index.md`
- Updated **Product status** from "internal preview" to "Early Access"
with a link to the early-access page for enablement instructions.
---
 docs/ai-coder/agents/early-access.md | 27 +++++++++++++++++++++++++++
 docs/ai-coder/agents/index.md        |  8 +++-----
 2 files changed, 30 insertions(+), 5 deletions(-)

diff --git a/docs/ai-coder/agents/early-access.md b/docs/ai-coder/agents/early-access.md
index 45443be5b2..e305aa7755 100644
--- a/docs/ai-coder/agents/early-access.md
+++ b/docs/ai-coder/agents/early-access.md
@@ -40,6 +40,33 @@ Functionality available during Early Access may be a subset of planned
 capabilities. Some features may be incomplete, experimental, or subject to
 redesign.
 
+## Enable Coder Agents
+
+Coder Agents is experimental and must not be deployed to production
+environments. It is gated behind the `agents` experiment flag. To enable it,
+pass the flag when starting the Coder server using an environment variable
+or CLI flag:
+
+```sh
+CODER_EXPERIMENTS="agents" coder server
+# or
+coder server --experiments=agents
+```
+
+If you are already using other experiments, add `agents` to the
+comma-separated list:
+
+```sh
+CODER_EXPERIMENTS="agents,oauth2,mcp-server-http" coder server
+```
+
+Once the server restarts with the experiment enabled:
+
+1. Navigate to the **Agents** page in the Coder dashboard.
+1. Open **Admin** settings and configure at least one LLM provider and model.
+   See [Models](./models.md) for detailed setup instructions.
+1. Developers can then start a new chat from the Agents page.
+
 ## Licensing and availability
 
 Features provided during Early Access may become paid licensed
diff --git a/docs/ai-coder/agents/index.md b/docs/ai-coder/agents/index.md
index eec20e1515..7c813efbeb 100644
--- a/docs/ai-coder/agents/index.md
+++ b/docs/ai-coder/agents/index.md
@@ -247,8 +247,6 @@ Coder Agents is a new approach that differs from
 
 ## Product status
 
-Coder Agents is currently in internal preview. We are actively developing the
-feature and demoing it with customers for feedback.
-
-Our next step is to offer an early access program for interested customers. If
-you would like to participate, [contact us](https://coder.com/contact).
+Coder Agents is in Early Access. The feature is under active development and
+available for evaluation. See [Early Access](./early-access.md) for
+enablement instructions and program details.