From b363187425e78dafee0b15571d750f9fae5b07eb Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Tue, 28 Apr 2026 22:16:52 +0000
Subject: [PATCH] Document agent presence and live cursor in the web editor

Generated-By: mintlify-agent
---
 agent/index.mdx        |  2 ++
 editor/collaborate.mdx | 12 ++++++++++++
 2 files changed, 14 insertions(+)

diff --git a/agent/index.mdx b/agent/index.mdx
index 9a027e2cc..6d91320eb 100644
--- a/agent/index.mdx
+++ b/agent/index.mdx
@@ -18,6 +18,8 @@ The agent is an AI tool that creates pull requests with proposed changes to your
 
 All changes go through pull requests. The agent never commits directly to your main branch.
 
+When the agent edits a page on a branch you have open in the [web editor](/editor/collaborate#see-the-agents-edits-in-real-time), its presence and cursor appear live so you can watch changes stream in as they happen.
+
 ## What you can do with the agent
 
 Use the agent to:
diff --git a/editor/collaborate.mdx b/editor/collaborate.mdx
index 1726f8494..4194d8784 100644
--- a/editor/collaborate.mdx
+++ b/editor/collaborate.mdx
@@ -62,6 +62,18 @@ Share the preview deployment URL with team members to gather feedback. Previews
 
 Preview URLs are publicly accessible by default. Enable preview authentication in the [Add-ons](https://dashboard.mintlify.com/products/addons) page of your dashboard to restrict access to authenticated organization members.
 
+## See the agent's edits in real time
+
+When the [agent](/agent) edits a page through the API or MCP, its presence appears in the web editor like any other collaborator. If you have the page open, you see the agent's avatar and name (`Claude`) at the top of the editor and a live cursor at the location of its most recent edit.
+
+Use this to:
+
+- Watch agent changes stream into the page as they happen.
+- Spot which paragraph or block the agent just rewrote without diffing the file.
+- Coordinate with teammates and the agent on the same branch without overwriting each other's work.
+
+The agent's cursor is anchored to the end of its most recent edit and clears automatically a short time after the agent finishes. The agent's edits are saved to the branch you opened the editor on, so reload or switch branches to see the published state.
+
 ## Share editor links
 
 Share a direct link to a specific page in the editor with your teammates. Use editor links to collaborate on updates and make changes to pages.