From 4dba280f5f8db80e9be614a7f69dd47882cca9a2 Mon Sep 17 00:00:00 2001
From: hanzheng1954 <1191820360@qq.com>
Date: Sat, 4 Jul 2026 09:46:48 +0000
Subject: [PATCH] ui: clarify orchestrator mode behavior

Co-authored-by: Shelley <shelley@exe.dev>
---
 ui/src/styles.css                           | 11 +++++++++++
 ui/src/vue/components/ChatInterface.vue     |  3 ++-
 ui/src/vue/components/ChatStatusContent.vue |  8 ++++++++
 3 files changed, 21 insertions(+), 1 deletion(-)

diff --git a/ui/src/styles.css b/ui/src/styles.css
index cc7f604f..9385fcfd 100644
--- a/ui/src/styles.css
+++ b/ui/src/styles.css
@@ -4000,6 +4000,17 @@ svg {
   flex: 1;
 }
 
+.tool-override-warning {
+  margin: 0.35rem 0 0.45rem;
+  padding: 0.45rem 0.55rem;
+  border: 1px solid rgba(202, 138, 4, 0.35);
+  border-radius: 0.375rem;
+  background: rgba(202, 138, 4, 0.12);
+  color: var(--text-secondary);
+  font-size: 0.6875rem;
+  line-height: 1.35;
+}
+
 .tool-override-suboption {
   padding-left: 1rem;
   justify-content: flex-start;
diff --git a/ui/src/vue/components/ChatInterface.vue b/ui/src/vue/components/ChatInterface.vue
index 9a21ca5b..2b318708 100644
--- a/ui/src/vue/components/ChatInterface.vue
+++ b/ui/src/vue/components/ChatInterface.vue
@@ -646,7 +646,8 @@ const toolOverrideCount = computed(() => Object.keys(toolOverrides.value).length
 
 const orchestratorPseudoTool = {
   name: "orchestrator",
-  summary: "Shelley orchestrator mode (delegates to subagents).",
+  summary:
+    "Advanced mode: the main agent delegates execution to subagents instead of using shell/file tools directly.",
   default_on: false,
 };
 const toolOverrideList = computed(() => [orchestratorPseudoTool, ...availableTools.value]);
diff --git a/ui/src/vue/components/ChatStatusContent.vue b/ui/src/vue/components/ChatStatusContent.vue
index 31008b1e..2bc08b3b 100644
--- a/ui/src/vue/components/ChatStatusContent.vue
+++ b/ui/src/vue/components/ChatStatusContent.vue
@@ -159,6 +159,14 @@
                   </button>
                 </div>
               </div>
+              <div
+                v-if="tool.name === 'orchestrator' && toolOverrides['orchestrator'] === 'on'"
+                class="tool-override-warning"
+              >
+                Orchestrator changes the conversation mode: the main agent will plan and delegate
+                work to subagents, and will not run shell or edit files directly. Leave this off
+                for normal coding sessions.
+              </div>
               <div
                 v-if="tool.name === 'orchestrator' && toolOverrides['orchestrator'] === 'on'"
                 class="tool-override-row tool-override-suboption"