diff --git a/packages/kilo-docs/pages/automate/agent-manager.md b/packages/kilo-docs/pages/automate/agent-manager.md
index 102d9f6461..862202a4d1 100644
--- a/packages/kilo-docs/pages/automate/agent-manager.md
+++ b/packages/kilo-docs/pages/automate/agent-manager.md
@@ -230,6 +230,21 @@ Press `Cmd+D` (macOS) / `Ctrl+D` (Windows/Linux) to toggle the diff panel. It sh
 - Markdown files include an eye/code toggle in the file header to switch between rendered Markdown and the raw diff
 - **Drag file headers into chat** — drag a file header from the diff panel into the chat input to insert an `@file` mention, giving the agent context about specific changed files
 
+## Documents inspector
+
+The Documents inspector previews files referenced from Agent Manager chat and review surfaces without leaving the panel. Open a file reference to add it as a document tab, then use the tab strip to switch, reorder, or close open documents. The inspector keeps one tab per file in the active project and worktree context.
+
+- Markdown files (`.md`, `.mdx`, and `.markdown`) open in rendered view by default. Use the preview/source toggle to switch between rendered Markdown and syntax-highlighted source.
+- Text files show a syntax-highlighted preview. Supported images (PNG, JPEG, GIF, WebP, and SVG) show as inline image previews.
+- Use **Open file** to open the document in the native VS Code editor. The original line and column are preserved when available. Files that are not handled by the inspector, such as source-file references, open in the native editor instead.
+- Unsupported, binary, missing, out-of-scope, or oversized files show an error fallback in the inspector. Text previews are limited to 2 MB and image previews to 5 MB; open the file in VS Code to inspect larger or unsupported content.
+
+### Inline document review
+
+In a rendered Markdown preview, use the line gutter or line number to add a comment at that line. Draft comments can be edited or deleted, sent individually to the active session, or sent together with **Send all to chat**. Comments are attached to the document path and line, and remain isolated to the active project and worktree context.
+
+The project and worktree context owns document tabs, loaded content, and comments. The session ID attached to an opened file selects the session's worktree for reading and native-editor navigation. Sessions that share one worktree also share its document inspector state; switching project or worktree changes the visible context without mixing tabs or comments across worktrees.
+
 ### Diff Scope
 
 A scope selector in the diff toolbar (both in the side panel and the full-screen review) chooses which changes the diff shows: