diff --git a/README.md b/README.md
index 438959b..c91d3e3 100644
--- a/README.md
+++ b/README.md
@@ -163,6 +163,30 @@ cd unlimitedcoding
 | Windows PowerShell | `powershell -ExecutionPolicy Bypass -File claude\releases\v2.1.71\install.ps1` |
 <!-- MANUAL_VERSION:END -->
 
+## Troubleshooting
+
+### Gemini CLI: deprecated settings spam
+
+If you see repeated warnings like:
+```
+The system configuration contains deprecated settings: [experimental.codebaseInvestigatorSettings]
+```
+
+Fix:
+```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')"
+```
+
+### Gemini CLI: Session cleanup disabled
+
+If you see: `Session cleanup disabled: Either maxAge or maxCount must be specified`
+
+This is harmless — Gemini CLI just skips old session cleanup. No action needed.
+
+### npm warnings during install
+
+Warnings like `deprecated prebuild-install`, `deprecated node-domexception`, `deprecated glob` are normal — these are Google's dependencies, not ours. They don't affect functionality.
+
 ## What Gets Installed Automatically
 
 | Component | Linux | macOS | Windows |