diff --git a/docs/setup/backend-services.md b/docs/setup/backend-services.md
index 7f1da36e8..b7b288bb8 100644
--- a/docs/setup/backend-services.md
+++ b/docs/setup/backend-services.md
@@ -540,7 +540,7 @@ setInterval(() => cleanupSessions(24 * 60 * 60 * 1000), 60 * 60 * 1000);
 | **Single CLI server = single point of failure** | See [Scaling guide](./scaling.md) for HA patterns |
 | **No built-in auth between SDK and CLI** | Secure the network path (same host, VPC, etc.) |
 | **Session state on local disk** | Mount persistent storage for container restarts |
-| **30-minute idle timeout** | Sessions without activity are auto-cleaned |
+| **No idle timeout by default** | Pass `--session-idle-timeout <seconds>` to the CLI server to automatically clean up inactive sessions |
 
 ## When to move on
 
diff --git a/docs/setup/scaling.md b/docs/setup/scaling.md
index c4a7a0953..acf82bdb2 100644
--- a/docs/setup/scaling.md
+++ b/docs/setup/scaling.md
@@ -626,7 +626,7 @@ flowchart TB
 | **No built-in session locking** | Implement application-level locking for concurrent access |
 | **No built-in load balancing** | Use external LB or service mesh |
 | **Session state is file-based** | Requires shared filesystem for multi-server setups |
-| **30-minute idle timeout** | Sessions without activity are auto-cleaned by the CLI |
+| **No idle timeout by default** | Pass `--session-idle-timeout <seconds>` to the CLI server to automatically clean up inactive sessions |
 | **CLI is single-process** | Scale by adding more CLI server instances, not threads |
 
 ## Next steps