fix: clarify workflow slash command hints

Author: ThomasK33

src/browser/features/RightSidebar/Workflows/WorkflowEmptyState.tsx

@@ -1,6 +1,7 @@
 import React from "react";
 import { BookOpen, Play, Workflow } from "lucide-react";
 
+import { SLASH_COMMAND_HINTS } from "@/common/constants/slashCommandHints";
 import type { AvailableWorkflow, WorkflowArgSummary } from "@/common/types/workflow";
 
 import { WorkflowScopeBadge } from "./WorkflowBadges";
@@ -231,11 +232,12 @@ export const WorkflowEmptyState: React.FC<WorkflowEmptyStateProps> = (props) =>
       )}
 
       <div className="text-muted pt-1 text-center text-[11.5px]">
-        Or start one from chat with{" "}
+        Start one from chat with{" "}
         <span className="border-border bg-surface-secondary rounded border px-1.5 py-px font-mono">
-          /
+          {`/workflow ${SLASH_COMMAND_HINTS.workflow}`}
         </span>
-        , or author one in <span className="text-content-secondary font-mono">.mux/workflows/</span>
+        ; workspace <span className="text-content-secondary font-mono">.js</span> workflows are
+        loaded by explicit path.
       </div>
     </div>
   );

src/browser/utils/slashCommands/ghostHint.test.ts

@@ -58,6 +58,17 @@ describe("getCommandGhostHint", () => {
     ).toBe(SLASH_COMMAND_HINTS.heartbeat);
   });
 
+  it("returns only workflow args after the typed /workflow command", () => {
+    const enabledExperiments = new Set<ExperimentId>([EXPERIMENT_IDS.DYNAMIC_WORKFLOWS]);
+
+    const hint = getCommandGhostHint("/workflow ", false, {
+      isExperimentEnabled: (experimentId) => enabledExperiments.has(experimentId),
+    });
+
+    expect(hint).toBe("<script_path> [args]");
+    expect(hint).not.toContain("/workflow");
+  });
+
   it("returns goal hints regardless of experiment state after GA", () => {
     expect(
       getCommandGhostHint("/goal ", false, {

src/browser/utils/slashCommands/registry.ts

@@ -665,13 +665,13 @@ const btwCommandDefinition: SlashCommandDefinition = {
   },
 };
 
-const WORKFLOW_COMMAND_USAGE = "/workflow <script_path> [args]";
+const WORKFLOW_COMMAND_USAGE = `/workflow ${SLASH_COMMAND_HINTS.workflow}`;
 
 const workflowCommandDefinition: SlashCommandDefinition = {
   key: "workflow",
   description: "Run an explicit workflow by script path",
   experimentGate: EXPERIMENT_IDS.DYNAMIC_WORKFLOWS,
-  inputHint: WORKFLOW_COMMAND_USAGE,
+  inputHint: SLASH_COMMAND_HINTS.workflow,
   handler: ({ rawInput }): ParsedCommand => {
     const trimmed = rawInput.trim();
     if (!trimmed) {

src/common/constants/slashCommandHints.ts

@@ -12,4 +12,5 @@ export const SLASH_COMMAND_HINTS = {
   heartbeat: "<minutes>|off",
   goal: "[-b <amount>] [--turns <n>] <objective>|budget <amount>|clear",
   btw: "<question>",
+  workflow: "<script_path> [args]",
 } as const satisfies Readonly<Record<string, string>>;