feat(workflow): add read-only project TUI

Author: Waishnav

package.json

@@ -28,7 +28,7 @@
     "dev": "node scripts/dev-server.mjs",
     "postinstall": "node scripts/fix-node-pty-permissions.mjs",
     "start": "node dist/cli.js serve",
-    "test": "tsx src/config.test.ts && tsx src/ui/card-types.test.ts && tsx src/ui/patch-display.test.ts && tsx src/ui/tool-display.test.ts && tsx src/apply-patch.test.ts && tsx src/process-platform.test.ts && tsx src/process-sessions.test.ts && tsx src/mcp-sessions.test.ts && tsx src/server-shutdown.test.ts && tsx src/local-agent-runtime.test.ts && tsx src/local-agent-adapters.test.ts && tsx src/local-agent-availability.test.ts && tsx src/local-agent-profiles.test.ts && tsx src/local-agent-targets.test.ts && tsx src/local-agent-store.test.ts && tsx src/roots.test.ts && tsx src/skills.test.ts && tsx src/workspaces.test.ts && tsx src/review-checkpoints.test.ts && tsx src/oauth-store.test.ts && tsx src/cli.test.ts && tsx src/workflow-contracts.test.ts && tsx src/workflow-errors.test.ts && tsx src/workflow-types.test.ts && tsx src/workflow-store.test.ts && tsx src/workflow-view.test.ts && tsx src/workflow-script.test.ts && tsx src/workflow-sandbox.test.ts && tsx src/workflow-engine.test.ts && tsx src/workflow-files.test.ts && tsx src/workflow-replay.test.ts && tsx src/workflow-schema.test.ts",
+    "test": "tsx src/config.test.ts && tsx src/ui/card-types.test.ts && tsx src/ui/patch-display.test.ts && tsx src/ui/tool-display.test.ts && tsx src/apply-patch.test.ts && tsx src/process-platform.test.ts && tsx src/process-sessions.test.ts && tsx src/mcp-sessions.test.ts && tsx src/server-shutdown.test.ts && tsx src/local-agent-runtime.test.ts && tsx src/local-agent-adapters.test.ts && tsx src/local-agent-availability.test.ts && tsx src/local-agent-profiles.test.ts && tsx src/local-agent-targets.test.ts && tsx src/local-agent-store.test.ts && tsx src/roots.test.ts && tsx src/skills.test.ts && tsx src/workspaces.test.ts && tsx src/review-checkpoints.test.ts && tsx src/oauth-store.test.ts && tsx src/cli.test.ts && tsx src/workflow-contracts.test.ts && tsx src/workflow-errors.test.ts && tsx src/workflow-types.test.ts && tsx src/workflow-store.test.ts && tsx src/workflow-view.test.ts && tsx src/workflow-tui.test.ts && tsx src/workflow-script.test.ts && tsx src/workflow-sandbox.test.ts && tsx src/workflow-engine.test.ts && tsx src/workflow-files.test.ts && tsx src/workflow-replay.test.ts && tsx src/workflow-schema.test.ts",
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "keywords": [],

skills/dynamic-workflows/SKILL.md

@@ -25,6 +25,7 @@ devspace workflow cancel <runId>
 devspace workflow ls
 devspace workflow calls <runId>
 devspace workflow call <runId> <callIndex>
+devspace workflow tui [runId]
 ```
 
 Named scripts: `.devspace/workflows/<name>.js` or `workflows/<name>.js`.
@@ -115,6 +116,7 @@ depending on a replayed mutating call.
 ## When to use CLI vs MCP
 
 - **CLI**: host agent can shell; prefer for long runs + `--follow`.
+- **TUI**: `devspace workflow tui` opens a read-only live view for workflows associated with the current working directory.
 - **MCP**: ChatGPT plans; call `run_workflow`, then `workflow_status` until terminal. Disconnecting MCP does **not** kill the worker.
 
 ## Worked mini-examples

src/workflow-cli.ts

@@ -69,6 +69,11 @@ export async function runWorkflowCommand(
     case "call":
       await runWorkflowCall(rest, config);
       return;
+    case "tui": {
+      const { runWorkflowTui } = await import("./workflow-tui.js");
+      await runWorkflowTui(rest, config);
+      return;
+    }
     case "__worker":
       await runWorkflowWorker(rest, config);
       return;
@@ -96,6 +101,7 @@ export function printWorkflowHelp(): void {
       "  devspace workflow ls",
       "  devspace workflow calls <runId>",
       "  devspace workflow call <runId> <callIndex>",
+      "  devspace workflow tui [runId]  # current working directory",
     ].join("\n"),
   );
 }

src/workflow-tui.test.ts

@@ -0,0 +1,71 @@
+import assert from "node:assert/strict";
+import {
+  renderWorkflowTui,
+  resolveWorkflowTuiWorkspaceRoot,
+} from "./workflow-tui.js";
+import type { WorkflowProjectView } from "./workflow-view.js";
+
+const project: WorkflowProjectView = {
+  workspaceRoot: "/tmp/project",
+  version: "1",
+  runs: [
+    {
+      id: "wfr_1",
+      name: "Review auth",
+      status: "running",
+      source: "named",
+      scriptPath: "/tmp/review.js",
+      scriptHash: "abc",
+      workspaceRoot: "/tmp/project",
+      currentPhase: "Implementation",
+      calls: {
+        running: 1,
+        completed: 1,
+        cached: 0,
+        failed: 0,
+        cancelled: 0,
+        observed: 2,
+      },
+      phases: [
+        {
+          title: "Implementation",
+          calls: [
+            {
+              callIndex: 1,
+              status: "running",
+              provider: "codex",
+              label: "Patch auth",
+              isolation: "worktree",
+              fromCache: false,
+              updatedAt: "2026-07-26T10:00:02.000Z",
+            },
+          ],
+        },
+      ],
+      unphasedCalls: [],
+      recentActivity: [
+        {
+          seq: 1,
+          type: "log",
+          detail: "Running tests",
+          createdAt: "2026-07-26T10:00:03.000Z",
+        },
+      ],
+      latestEventSeq: 1,
+      version: "v1",
+      createdAt: "2026-07-26T10:00:00.000Z",
+      startedAt: "2026-07-26T10:00:00.000Z",
+      updatedAt: "2026-07-26T10:00:03.000Z",
+    },
+  ],
+};
+
+const rendered = renderWorkflowTui(project, 0, 100, 30, { ansi: false });
+assert.match(rendered, /DevSpace workflows · \/tmp\/project/);
+assert.match(rendered, /Review auth · Implementation/);
+assert.match(rendered, /Patch auth  codex · worktree/);
+assert.match(rendered, /Running tests/);
+assert.match(rendered, /refreshes automatically/);
+assert.equal(resolveWorkflowTuiWorkspaceRoot("./test-project").endsWith("test-project"), true);
+
+console.log("workflow-tui.test.ts: ok");