Skip to content

Beautiful, AI-native markdown IDE and LLM wiki

fix(ok-docs): update activity panel doc (#1919)

miles-kt-inkeep11aa9aa008f8
diff --git a/docs/content/features/agent-activity.mdx b/docs/content/features/agent-activity.mdx
index a1a5194c8..75c6a912c 100644
--- a/docs/content/features/agent-activity.mdx
+++ b/docs/content/features/agent-activity.mdx
@@ -1,27 +1,27 @@
---
title: Agent activity
-description: See every file an agent edits in a session, with per-burst diffs and selective rollback.
+description: See every file an agent edits in a session, with per-edit diffs and selective rollback.
---
-Agent activity shows all edits made by an agent during its current editing session. It is built for quick review: see which files changed, inspect each burst of edits, and undo any agent work you do not want to keep.
+Agent activity shows all edits made by an agent during its current editing session. It is built for quick review: see which files changed, inspect each edit, and undo any agent work you do not want to keep.
## Open agent activity
-Click an agent avatar in the presence bar to open that agent's activity view. The panel stays focused on the selected agent, even as you move between documents.
+Avatar icons will appear in the top right of the editor whenever an agent or a human is editing a document. You can click on an agent's avatar icon to open the activity panel for that agent.
+
+The activity panel displays the list of files that the agent has edited in the current session.
## What you can see
-The activity panel groups edits by file. Each file row shows the total additions and deletions from that agent.
+The activity panel groups edits by file. Each file row shows the total additions and deletions made by the agent.
-Expand a file to see individual edit bursts. Each burst has its own additions, deletions, timestamp, and diff.
+Expand a file to see individual edits. Each edit has its own additions, deletions, timestamp, and diff.
## Undo agent edits
-When the agent session is still active, you can undo:
-
-- The agent's latest edit burst in a file
-- All tracked edits from that agent in a file
+While an agent's session is still active, you can undo:
-Undo actions are scoped to the selected agent session. They do not roll back unrelated human edits or other agents' work.
+- The agent's latest edit in a file
+- All edits made by an agent in a file at once
After the agent session ends, the activity panel still shows the session's edits for review, but undo is no longer available. Use the [timeline](/docs/features/timeline-and-recovery) to roll back changes from a closed session.