From c14848931524349aaa7f3fb2c3fcc8225ae19e01 Mon Sep 17 00:00:00 2001
From: Rens Tillmann <rens@super-forms.com>
Date: Fri, 20 Mar 2026 18:23:53 +0100
Subject: [PATCH] docs: add changelog for screenshot path option

Bug fixes:
- Add browser.screenshotDir to settings-schema.ts (lost during rebase conflict)
- Fix stale expandHome comment to expandPath in settings-selector.ts
- Final screenshotDir description: Directory to save screenshots with ~ support
---
 packages/coding-agent/CHANGELOG.md                        | 4 ++++
 packages/coding-agent/src/config/settings-schema.ts       | 8 ++++++++
 .../src/modes/components/settings-selector.ts             | 2 +-
 3 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/packages/coding-agent/CHANGELOG.md b/packages/coding-agent/CHANGELOG.md
index b46ddfda3..905ab15ab 100644
--- a/packages/coding-agent/CHANGELOG.md
+++ b/packages/coding-agent/CHANGELOG.md
@@ -2,6 +2,10 @@
 
 ## [Unreleased]
 
+### Added
+
+- Added `browser.screenshotDir` setting to configure screenshot save directory with path expansion
+
 ## [13.13.2] - 2026-03-18
 
 ### Added
diff --git a/packages/coding-agent/src/config/settings-schema.ts b/packages/coding-agent/src/config/settings-schema.ts
index 5567601b7..c48b6b777 100644
--- a/packages/coding-agent/src/config/settings-schema.ts
+++ b/packages/coding-agent/src/config/settings-schema.ts
@@ -1155,6 +1155,14 @@ export const SETTINGS_SCHEMA = {
 			description: "Launch browser in headless mode (disable to show browser UI)",
 		},
 	},
+	"browser.screenshotDir": {
+		type: "string",
+		ui: {
+			tab: "tools",
+			label: "Screenshot directory",
+			description: "Directory to save screenshots. If unset, screenshots go to a temp file. Supports ~. Examples: ~/Downloads, ~/Desktop, /sdcard/Download (Android)",
+		},
+	},
 
 	// Tool execution
 	"tools.intentTracing": {
diff --git a/packages/coding-agent/src/modes/components/settings-selector.ts b/packages/coding-agent/src/modes/components/settings-selector.ts
index d41bae42b..e2a45d036 100644
--- a/packages/coding-agent/src/modes/components/settings-selector.ts
+++ b/packages/coding-agent/src/modes/components/settings-selector.ts
@@ -463,7 +463,7 @@ export class SettingsSelectorComponent extends Container {
 			currentValue,
 			value => {
 				// Empty string clears the setting; undefined-typed string settings
-				// store "" which the browser.ts expandHome ignores (no-op fallback).
+				// store "" which the browser.ts expandPath ignores (no-op fallback).
 				this.#setSettingValue(def.path, value);
 				this.callbacks.onChange(def.path, value);
 				wrappedDone(value);