From d76493a63ac29fcadcd3550a4742c460c63a8919 Mon Sep 17 00:00:00 2001
From: chengyongru <chengyongru.ai@gmail.com>
Date: Wed, 1 Jul 2026 18:05:58 +0800
Subject: [PATCH] docs: clarify Windows exec shell syntax

Maintainer edit: document that Windows exec commands use PowerShell syntax by default and shell='cmd' is the cmd-specific escape hatch.
---
 nanobot/agent/tools/shell.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/nanobot/agent/tools/shell.py b/nanobot/agent/tools/shell.py
index 05c612d5..02dc3ec3 100644
--- a/nanobot/agent/tools/shell.py
+++ b/nanobot/agent/tools/shell.py
@@ -234,6 +234,8 @@ class ExecTool(Tool):
             "inspection and apply_patch/write_file/edit_file for file changes "
             "instead of cat, shell find/grep, echo, or sed. "
             "Use -y or --yes flags to avoid interactive prompts. "
+            "On Windows, use PowerShell syntax by default; pass shell='cmd' "
+            "only for cmd-specific commands. "
             "For long-running or interactive commands, pass yield_time_ms; "
             "if the command keeps running, exec returns a session_id that can "
             "be polled or written to with write_stdin. Output is truncated at "