diff --git a/CHANGELOG.md b/CHANGELOG.md
index 1015934..7b1b02f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -8,6 +8,38 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ---
 
 ## [Unreleased]
+# 🚀 New: `--auto-deps` for single-file C++ (script mode)
+
+You can now use libraries installed from the Vix registry directly inside a single `.cpp` file:
+
+```bash
+vix run server.cpp --auto-deps
+```
+
+- Automatically detects installed dependencies in `.vix/deps`
+- Injects the correct `-I` include paths
+- Avoids duplicate include flags
+- No `CMakeLists.txt` required
+
+---
+
+# 🔼 New: `--auto-deps=up`
+
+```bash
+vix run src/server.cpp --auto-deps=up
+```
+
+In addition to the script directory, Vix can now search for `.vix/deps` in parent directories.
+Useful for nested layouts and running scripts from subfolders.
+
+---
+
+# 🧠 Improvements
+
+- Introduced `AutoDepsMode` (`None`, `Local`, `Up`)
+- Proper validation and error handling for invalid `--auto-deps` values
+- Improved `vix run --help` documentation
+- Cleaner separation between runtime args (`--args`) and compiler flags (`--`)
 ## [v1.36.3] - 2026-02-19
 
 ### Improved
diff --git a/modules/cli b/modules/cli
index 967f72c..133cdd0 160000
--- a/modules/cli
+++ b/modules/cli
@@ -1 +1 @@
-Subproject commit 967f72cd9580d704b885eaf10be50f8f1adf81b9
+Subproject commit 133cdd0c7ef72b0e38d02f75c1f0ccdcc4d2f5c0