diff --git a/editor/collaborate.mdx b/editor/collaborate.mdx
index f6d8ad36b..cba7c0af8 100644
--- a/editor/collaborate.mdx
+++ b/editor/collaborate.mdx
@@ -37,7 +37,17 @@ Use this to:
 - See which paragraph or block the agent just updated without diffing the file.
 - Coordinate with teammates and the agent on the same branch without overwriting each other's work.
 
-The agent's cursor clears automatically a short time after the agent finishes editing.
+The agent's cursor and selection highlight fade out a short time after the agent finishes editing, so completed edits don't clutter the page.
+
+### Agent attribution
+
+When an agent edits on behalf of a teammate, the editor shows who authorized the request alongside the agent itself:
+
+- The live cursor label displays the agent name and the authorizing user, separated by a dot. For example, `Docs agent · Jordan Lee`.
+- The cursor avatar stacks the agent's avatar with the authorizing user's avatar, so you can see at a glance which teammate triggered the edit.
+- The collaborator list in the toolbar shows the same stacked avatars. Open the overflow menu to see a `via {teammate}` line under each agent.
+
+If an agent runs without an authorizing user, only the agent's name and avatar appear.
 
 ## Branch-based collaboration