From ff7d21522ae50f1432eb57eef135a27199a8a03e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Eren=20=C3=87akar?= <super.erencakar@gmail.com>
Date: Sun, 31 May 2026 16:26:19 +0300
Subject: [PATCH] feat(ui): add instruction hints to command and prompt dialogs
 (#4150)

Add helper text below prompt/description textareas in the quick command
dialog, automation editor dialog, and create PR dialog to inform users
about supported features like skills, file paths, and built-in commands.

Closes #3998
---
 .../src/components/automations/AutomationEditorDialog.tsx     | 4 ++++
 .../src/components/right-sidebar/CreatePullRequestDialog.tsx  | 3 +++
 .../terminal-quick-commands/TerminalQuickCommandDialog.tsx    | 4 ++++
 3 files changed, 11 insertions(+)

diff --git a/src/renderer/src/components/automations/AutomationEditorDialog.tsx b/src/renderer/src/components/automations/AutomationEditorDialog.tsx
index e43234d5658..222f048665b 100644
--- a/src/renderer/src/components/automations/AutomationEditorDialog.tsx
+++ b/src/renderer/src/components/automations/AutomationEditorDialog.tsx
@@ -232,6 +232,10 @@ export function AutomationEditorDialog({
               }
               className="min-h-[260px] w-full resize-none rounded-md border border-input bg-transparent px-3 py-2 text-sm shadow-xs outline-none placeholder:text-muted-foreground focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50 dark:bg-input/30"
             />
+            <p className="mt-1 text-xs text-muted-foreground">
+              Supports skills, file paths, and built-in commands like{' '}
+              <code className="rounded bg-muted px-1 font-mono text-[11px]">/goal</code>.
+            </p>
           </Field>
           {isHermesCreate ? null : (
             <div className="mt-3 grid gap-3 sm:grid-cols-[minmax(0,1fr)_9rem]">
diff --git a/src/renderer/src/components/right-sidebar/CreatePullRequestDialog.tsx b/src/renderer/src/components/right-sidebar/CreatePullRequestDialog.tsx
index ae5472edf51..1be5d54678f 100644
--- a/src/renderer/src/components/right-sidebar/CreatePullRequestDialog.tsx
+++ b/src/renderer/src/components/right-sidebar/CreatePullRequestDialog.tsx
@@ -402,6 +402,9 @@ export function CreatePullRequestDialog({
               placeholder="Description (optional)"
               className="w-full resize-none rounded-md border border-border bg-background px-3 py-2 text-sm text-foreground outline-none placeholder:text-muted-foreground/70 focus-visible:ring-1 focus-visible:ring-ring"
             />
+            <p className="text-xs text-muted-foreground">
+              Supports Markdown formatting. Use Generate with AI to auto-fill from your changes.
+            </p>
           </div>
 
           <label className="flex items-center gap-2 rounded-md border border-border bg-background px-3 py-2 text-sm text-foreground transition-colors hover:bg-accent hover:text-accent-foreground">
diff --git a/src/renderer/src/components/terminal-quick-commands/TerminalQuickCommandDialog.tsx b/src/renderer/src/components/terminal-quick-commands/TerminalQuickCommandDialog.tsx
index 60eb8dfd5c4..50a4d276f4b 100644
--- a/src/renderer/src/components/terminal-quick-commands/TerminalQuickCommandDialog.tsx
+++ b/src/renderer/src/components/terminal-quick-commands/TerminalQuickCommandDialog.tsx
@@ -263,6 +263,10 @@ export function TerminalQuickCommandDialog({
                   rows={4}
                   className="min-h-24 w-full resize-y rounded-md border border-input bg-transparent px-3 py-2 text-sm shadow-xs outline-none transition-[color,box-shadow] focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50"
                 />
+                <p className="text-xs text-muted-foreground">
+                  Supports skills, file paths, and built-in commands like{' '}
+                  <code className="rounded bg-muted px-1 font-mono text-[11px]">/goal</code>.
+                </p>
               </div>
             </>
           ) : (