diff --git a/docs/ai-coder/agents/chat-sharing.md b/docs/ai-coder/agents/chat-sharing.md new file mode 100644 index 0000000000..89a9391d0e --- /dev/null +++ b/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. diff --git a/docs/manifest.json b/docs/manifest.json index fa1b7c0f38..d0485b6ca8 100644 --- a/docs/manifest.json +++ b/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",