diff --git a/crates/settings_content/src/agent.rs b/crates/settings_content/src/agent.rs
index d5169b2563..917ca5e053 100644
--- a/crates/settings_content/src/agent.rs
+++ b/crates/settings_content/src/agent.rs
@@ -151,7 +151,7 @@ pub struct AgentSettingsContent {
     pub play_sound_when_agent_done: Option<PlaySoundWhenAgentDone>,
     /// Whether to display agent edits in single-file editors in addition to the review multibuffer pane.
     ///
-    /// Default: true
+    /// Default: false
     pub single_file_review: Option<bool>,
     /// Additional parameters for language model requests. When making a request
     /// to a model, parameters will be taken from the last entry in this list
diff --git a/docs/src/ai/agent-panel.md b/docs/src/ai/agent-panel.md
index 95588b025f..df3cafb1e8 100644
--- a/docs/src/ai/agent-panel.md
+++ b/docs/src/ai/agent-panel.md
@@ -120,9 +120,16 @@ To see which files specifically have been edited, expand the accordion bar that
 
 You can accept or reject each individual change hunk, or the whole set of changes made by the agent.
 
-Edit diffs also appear in singleton buffers.
-If your active tab had edits made by the AI, you'll see diffs with the same accept/reject controls as in the multi-buffer.
-You can turn this off, though, through the `agent.single_file_review` setting.
+Edit diffs can also appear inline in individual files with the same
+keep/reject hunk controls as the multi-buffer review pane. This temporarily overrides the buffer's git diff while review is active. Enable it by setting `agent.single_file_review` to `true` in your settings:
+
+```json
+{
+  "agent": {
+    "single_file_review": true
+  }
+}
+```
 
 ## Terminal Threads {#terminal-threads}