docs: document chat sharing#25592
Conversation
Docs preview📖 View docs preview for |
8a0d976 to
091ee4c
Compare
45cfe0e to
b968ad7
Compare
b968ad7 to
e272ec6
Compare
|
|
||
| ## Share a chat | ||
|
|
||
| 1. Open the root chat you want to share on the **Agents** page. |
There was a problem hiding this comment.
Root is unfamiliar to readers.
There was a problem hiding this comment.
🤖 This comment was written by Coder Agent on behalf of Danielle Maywood 🤖
Switched to "top-level chats" and "sub-agent chats" and merged the inheritance note into the same step. Fixed in 4f522e1.
|
|
||
| Coder does not create a separate share link or notify recipients. Shared users and groups must open the chat from the URL you send them. | ||
|
|
||
| Sub-agent child chats inherit sharing from the root chat and cannot be shared separately. |
There was a problem hiding this comment.
Since we don’t surface the chat in the sidebar, they are inaccessible for the time being unless you find them in the chat history and access them that way.
There was a problem hiding this comment.
🤖 This comment was written by Coder Agent on behalf of Danielle Maywood 🤖
Good catch. Added a note that recipients reach sub-agent chats by following sub-agent links inside the parent chat or by opening a direct URL, since shared chats don't appear in their normal chat list. Fixed in 4f522e1.
|
|
||
| ## Shared chat access | ||
|
|
||
| Shared users can open the chat from a direct link, view messages, stream live updates, and download chat attachments. |
There was a problem hiding this comment.
I hope we’re not sharing users.
There was a problem hiding this comment.
🤖 This comment was written by Coder Agent on behalf of Danielle Maywood 🤖
"Shared users" is gone. Used "recipients" for the sending step and "viewers" for the read-only access description. Fixed in 4f522e1.
|
|
||
| Shared users can open the chat from a direct link, view messages, stream live updates, and download chat attachments. | ||
|
|
||
| Shared chats do not appear in the recipient's normal chat list. Read-only users cannot continue the chat, edit messages, archive it, regenerate its title, or change sharing. |
There was a problem hiding this comment.
It subject in archive feels a bit misplaced after edit messages. Consider reordering or restructuring. Change sharing => settings/preferences?
There was a problem hiding this comment.
🤖 This comment was written by Coder Agent on behalf of Danielle Maywood 🤖
Reordered the read-only restrictions and rephrased "change sharing" as "change its sharing settings". Fixed in 4f522e1.
|
@mafredri Apologies for the agent response, but I think the new change is an improvement. |
david-fraley
left a comment
There was a problem hiding this comment.
Generally ok with this, but have some questions/comments for ya
|
|
||
| ## 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. |
There was a problem hiding this comment.
Is there an in UI flag for this? Or does it have to be disabled via deployment config.
There was a problem hiding this comment.
I do not believe so, although I think we probably should to match Workspace Sharing, which is available at /organizations/coder/settings
|
|
||
| Chat sharing lets you give other users or groups read-only access to a Coder Agents conversation. | ||
|
|
||
| ## Share a chat |
There was a problem hiding this comment.
Is it worth calling out how to do this programmatically?
|
|
||
| ## 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. |
There was a problem hiding this comment.
Minor nit about ; use here, looks sloppy.
Note
🤖 This PR was written by Coder Agent on behalf of Danielle Maywood
Adds a dedicated Coder Agents Chat Sharing page instead of putting this detail in the overview.
The page covers sharing root chats with users or groups, read-only access behavior, direct-link access, inherited sub-agent chat sharing, and the deployment options for disabling chat sharing.