docs: document chat sharing (#25592)

docs/ai-coder/agents/chat-sharing.md

@@ -0,0 +1,24 @@
+# Chat Sharing
+
+Chat sharing lets you give other users or groups read-only access to a Coder Agents conversation.
+
+## Share a chat
+
+1. Open the chat you want to share on the **Agents** page. Only top-level chats can be shared; sub-agent chats inherit sharing from their parent.
+1. Click the share icon in the chat top bar.
+1. Click the **Search for user or group** field.
+1. Search for and select a user or group.
+1. Click **Add member** to grant **Read** access.
+1. Copy the chat URL from your browser and send it to the recipients.
+
+Coder does not create a separate share link or notify recipients. They must open the chat from the URL you send them.
+
+## Shared chat access
+
+Viewers can open the chat from a direct link, view messages, stream live updates, and download chat attachments. They reach sub-agent chats by following sub-agent links inside the parent chat or by opening a direct URL.
+
+Shared chats do not appear in the viewer's normal chat list. Viewers have read-only access: they cannot send or edit messages, regenerate the chat title, archive the chat, or change its sharing settings.
+
+## Disable chat sharing
+
+Administrators can disable chat sharing for a deployment with `--disable-chat-sharing`, `CODER_DISABLE_CHAT_SHARING`, or `disableChatSharing`. When disabled, only chat owners can access their chats.

docs/manifest.json

@@ -1007,6 +1007,12 @@
 							"path": "./ai-coder/agents/architecture.md",
 							"state": ["beta"]
 						},
+						{
+							"title": "Chat Sharing",
+							"description": "Share Coder Agents conversations with users and groups",
+							"path": "./ai-coder/agents/chat-sharing.md",
+							"state": ["beta"]
+						},
 						{
 							"title": "Models",
 							"description": "Configure LLM providers and models for Coder Agents",