From a65f12866a2b3521e6a6dd55e6f957f45a29ea1b Mon Sep 17 00:00:00 2001
From: delta-cloud-208e <delta-cloud-208e@device.local>
Date: Sat, 7 Mar 2026 08:52:46 +0000
Subject: [PATCH] docs: fix deprecated settings cleanup for all platforms

---
 README.md | 40 ++++++++++++++++++++++++++++++++++++++--
 1 file changed, 38 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index c91d3e3..063e126 100644
--- a/README.md
+++ b/README.md
@@ -172,9 +172,45 @@ If you see repeated warnings like:
 The system configuration contains deprecated settings: [experimental.codebaseInvestigatorSettings]
 ```
 
-Fix:
+The key exists in **system-level** config files. Fix all locations:
+
 ```bash
-python3 -c "import json; p='$HOME/.gemini/settings.json'; d=json.load(open(p)); e=d.get('experimental',{}); e.pop('codebaseInvestigatorSettings',None); [d.pop('experimental') for _ in '' if not e and 'experimental' in d]; json.dump(d,open(p,'w'),indent=2); print('Done')"
+# Linux
+for f in "$HOME/.gemini/settings.json" "/etc/gemini-cli/settings.json" "/etc/gemini-cli/system-defaults.json"; do
+  [ -f "$f" ] && python3 -c "
+import json,sys
+d=json.load(open('$f'))
+e=d.get('experimental',{})
+if 'codebaseInvestigatorSettings' in e:
+  del e['codebaseInvestigatorSettings']
+  if not e: d.pop('experimental',None)
+  json.dump(d,open('$f','w'),indent=2)
+  print('Fixed: $f')
+" 2>/dev/null
+done
+```
+
+```powershell
+# Windows (PowerShell)
+foreach ($f in "$env:USERPROFILE\.gemini\settings.json", "C:\ProgramData\gemini-cli\settings.json", "C:\ProgramData\gemini-cli\system-defaults.json") {
+  if (Test-Path $f) { $d = Get-Content $f | ConvertFrom-Json; if ($d.experimental.codebaseInvestigatorSettings) { $d.experimental.PSObject.Properties.Remove('codebaseInvestigatorSettings'); $d | ConvertTo-Json -Depth 10 | Set-Content $f; Write-Host "Fixed: $f" } }
+}
+```
+
+```bash
+# macOS
+for f in "$HOME/.gemini/settings.json" "/Library/Application Support/GeminiCli/settings.json"; do
+  [ -f "$f" ] && python3 -c "
+import json
+d=json.load(open('$f'))
+e=d.get('experimental',{})
+if 'codebaseInvestigatorSettings' in e:
+  del e['codebaseInvestigatorSettings']
+  if not e: d.pop('experimental',None)
+  json.dump(d,open('$f','w'),indent=2)
+  print('Fixed: $f')
+" 2>/dev/null
+done
 ```
 
 ### Gemini CLI: Session cleanup disabled