diff --git a/apps/web/src/components/app/docs-sections/agents.tsx b/apps/web/src/components/app/docs-sections/agents.tsx index 840e4f2d..589ee6b7 100644 --- a/apps/web/src/components/app/docs-sections/agents.tsx +++ b/apps/web/src/components/app/docs-sections/agents.tsx @@ -186,9 +186,32 @@ export function AgentsContent() {
Select one or more lines in a diff, then click the comment icon to - leave a note for the agent. The comment is injected into the agent's - terminal with the file path and line range so the agent can act on it - immediately. + leave feedback. The primary action is Start a review, + which enters review mode and saves the comment as a draft. Use the + dropdown to pick Chat instead — that sends the + comment directly to the agent's terminal as a one-off message (the + original behavior). +
+
+ In review mode, a bar at the top shows your draft count and a{" "}
+ Submit review button. Keep adding draft comments
+ across different files, then submit them all at once with an optional
+ summary. Each comment becomes a feedback item the agent can see via
+ its dispatch_review_list_feedback tool. The agent can
+ reply to individual items, resolve them, or ask clarifying questions —
+ all visible in the Reviews tab of the media sidebar.
+
+ Drag an inactive tab (Terminal or{" "} + Changes) onto the left or right drop zone to show + both side by side. A resize handle between the panes lets you adjust + the ratio. Click the unsplit button on the divider to + return to single-tab view. The split layout persists per agent. Split + pane is not available on mobile.
- Drag and drop agent cards in the sidebar to reorder them. You can also
- focus a card and press Alt+↑ or Alt+↓ to
- move it. The custom order is saved per session.
-
Click any agent's media count badge (or press{" "}
- Mod+Shift+>) to open the sidebar. The sidebar has
- three tabs: Pins, Media, and{" "}
- Brain.
+ Mod+Shift+>) to open the sidebar. The sidebar has four
+ tabs: Pins, Media,{" "}
+ Brain, and Reviews.
The Pins tab shows values the agent has surfaced via{" "} @@ -110,7 +110,12 @@ export function MediaContent() { with a badge. The Brain tab displays shared-memory objects, lists, and events the agent has written — useful for inspecting job state or inter-agent coordination without calling the - Brain tools yourself. + Brain tools yourself. The Reviews tab shows human + review feedback submitted from the Changes tab — each review has a + status badge (open, partially resolved, or resolved), and you can + expand it to see individual items, threaded messages, diff snapshots, + and resolutions. Click a file path to jump to that location in the + Changes tab.
The sidebar opens in drawer mode by default — diff --git a/apps/web/src/components/app/docs-sections/tools.tsx b/apps/web/src/components/app/docs-sections/tools.tsx index c70bd21b..bce1ea8b 100644 --- a/apps/web/src/components/app/docs-sections/tools.tsx +++ b/apps/web/src/components/app/docs-sections/tools.tsx @@ -171,22 +171,31 @@ export function ToolsContent() { the reviewer exits cleanly
dispatch_launch_agent — launch a new child agent to
- work on a subtask (see the Agents section for details)
+ dispatch_review_list_feedback — list human review
+ feedback items for this agent, including file paths, statuses, and
+ thread messages
list_agents — list other agents in the same repo with
- their IDs, statuses, and latest activity
+ dispatch_review_resolve — resolve a review feedback
+ item as fixed, ignored, or wont_fix
dispatch_send_message — send a message to another
- running agent by ID or name; the target can reply the same way
+ dispatch_review_add_message — reply to a review
+ feedback thread (ask a clarifying question or explain an approach)
dispatch_launch_agent — launch a new agent as a child
of the current session with a name, prompt, and optional agent type,
worktree settings, full access mode, or template
list_agents — list other agents in the same repo with
+ their IDs, statuses, and latest activity
+ dispatch_send_message — send a message to another
+ running agent by ID or name; the target can reply the same way
+ get_activity_summary, get_agent_history,{" "}
get_feedback_summary — analytics queries over recent
diff --git a/apps/web/src/lib/tips/tips.ts b/apps/web/src/lib/tips/tips.ts
index 42f7e358..33b60af4 100644
--- a/apps/web/src/lib/tips/tips.ts
+++ b/apps/web/src/lib/tips/tips.ts
@@ -154,6 +154,22 @@ export const tips: Tip[] = [
since: "0.24.0",
surfaces: ["ambient"],
},
+ {
+ id: "diff-review",
+ title: "Diff Review",
+ body: "Select lines in the Changes tab and submit review comments. The agent can respond, resolve items, or ask questions in threaded conversations.",
+ docsSection: "agents",
+ since: "0.27.0",
+ surfaces: ["ambient"],
+ },
+ {
+ id: "split-pane",
+ title: "Split Pane",
+ body: "Drag the Terminal or Changes tab to the left or right drop zone to view them side by side. Click the split button on the divider to unsplit.",
+ docsSection: "agents",
+ since: "0.27.0",
+ surfaces: ["ambient"],
+ },
];
export function getTipById(id: string): Tip | undefined {