Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 11 additions & 1 deletion editor/collaborate.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -22,14 +22,14 @@

When multiple team members edit the same branch, changes sync in real-time. Page content, navigation structure, and site configuration updates appear automatically for all collaborators without refreshing.

- Each person's cursor and edits are visible to everyone on the page, with user avatars and names shown in the toolbar.

Check warning on line 25 in editor/collaborate.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/collaborate.mdx#L25

Use 'Cursor' instead of 'cursor'.
- Changes merge automatically. Two people editing the same section won't cause conflicts.
- Undo only affects your own changes—undoing won't revert another person's edits.
- If you lose your network connection, your edits save locally and sync when you reconnect.

## See the agent's edits in real time

When the [Mintlify agent](/agent) edits a page through the API or MCP, it appears in the web editor like any other collaborator. If you have the page open on the same branch, you see the agent's avatar and name at the top of the editor and a live cursor at the location of its most recent edit.

Check warning on line 32 in editor/collaborate.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/collaborate.mdx#L32

Use 'Cursor' instead of 'cursor'.

Use this to:

Expand All @@ -37,7 +37,17 @@
- 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.

Check warning on line 40 in editor/collaborate.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/collaborate.mdx#L40

Use 'Cursor' instead of 'cursor'.

### 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`.

Check warning on line 46 in editor/collaborate.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/collaborate.mdx#L46

Use 'Cursor' instead of 'cursor'.
- 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.

Check warning on line 47 in editor/collaborate.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

editor/collaborate.mdx#L47

Use 'Cursor' instead of 'cursor'.
- 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

Expand Down
Loading