From 24b8af968b9dd0f92332ad41f16e33cd2f973848 Mon Sep 17 00:00:00 2001
From: Naved Merchant <14171946+navedmerchant@users.noreply.github.com>
Date: Tue, 4 Aug 2026 23:04:47 +0000
Subject: [PATCH] docs: clarify terminal command completion behavior

---
 docs/advanced-usage/available-tools/execute-command.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/advanced-usage/available-tools/execute-command.md b/docs/advanced-usage/available-tools/execute-command.md
index c5dadf7c..64e4b7d0 100644
--- a/docs/advanced-usage/available-tools/execute-command.md
+++ b/docs/advanced-usage/available-tools/execute-command.md
@@ -29,6 +29,8 @@ The tool accepts these parameters:
 
 This tool executes terminal commands directly on the user's system, enabling a wide range of operations from file manipulations to running development servers. Commands run in managed terminal instances with real-time output capture, integrated with VS Code's terminal system for optimal performance and security.
 
+Foreground commands remain attached to their tool call until they complete, so Zoo Code receives the final output and exit status before starting the next reasoning step. Commands continue in the background only when the tool call includes an explicit timeout.
+
 ---
 
 ## When is it used?