From 60baa765d942dcc40ee8bf0e58400aa634b6741a Mon Sep 17 00:00:00 2001
From: Ogulcan Celik <ogulcancelik@gmail.com>
Date: Sat, 28 Mar 2026 22:17:14 +0300
Subject: feat: block nested herdr instances by default

---
 CONFIGURATION.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

(limited to 'CONFIGURATION.md')

diff --git a/CONFIGURATION.md b/CONFIGURATION.md
index 75cd0471..dee645e2 100644
--- a/CONFIGURATION.md
+++ b/CONFIGURATION.md
@@ -153,6 +153,23 @@ available agent keys:
 - `droid`
 - `amp`
 
+## advanced
+
+```toml
+[advanced]
+allow_nested = false
+```
+
+### options
+
+| option | default | description |
+|--------|---------|-------------|
+| `advanced.allow_nested` | `false` | allow launching herdr from inside a herdr-managed pane |
+
+notes:
+- by default, herdr blocks nested launches when `HERDR_ENV=1` is already present
+- this is mainly an escape hatch for debugging or intentionally weird setups
+
 ## environment variables
 
 | variable | description |
-- 
cgit v1.2.3