From 94192bd21b2b7d94b43a259334e6dcc7833186f7 Mon Sep 17 00:00:00 2001 From: Cal Corum Date: Sun, 1 Mar 2026 18:38:21 -0600 Subject: [PATCH] store: Workflow: TUI testing with mcp-tui-driver in Claude Code --- ...th-mcp-tui-driver-in-claude-code-1177d1.md | 41 +++++++++++++++++++ 1 file changed, 41 insertions(+) create mode 100644 graph/workflows/workflow-tui-testing-with-mcp-tui-driver-in-claude-code-1177d1.md diff --git a/graph/workflows/workflow-tui-testing-with-mcp-tui-driver-in-claude-code-1177d1.md b/graph/workflows/workflow-tui-testing-with-mcp-tui-driver-in-claude-code-1177d1.md new file mode 100644 index 00000000000..543092e43ef --- /dev/null +++ b/graph/workflows/workflow-tui-testing-with-mcp-tui-driver-in-claude-code-1177d1.md @@ -0,0 +1,41 @@ +--- +id: 1177d1f5-6df7-42ae-beef-bbd6b22d2fae +type: workflow +title: "Workflow: TUI testing with mcp-tui-driver in Claude Code" +tags: [mcp, tui-testing, documentation, claude-home, workflow, development] +importance: 0.6 +confidence: 0.8 +created: "2026-03-02T00:38:21.757641+00:00" +updated: "2026-03-02T00:38:21.757641+00:00" +--- + +# TUI Testing Workflow with mcp-tui-driver + +## Context + +Documentation added to `development/tui-testing.md` in the claude-home repo. Context loading trigger added to `CLAUDE.md`. + +## Context Loading Trigger + +Keywords: `tui testing`, `mcp-tui-driver`, `tui automation`, `terminal ui test` +Loads: `development/tui-testing.md` + +## Typical Testing Workflow + +1. **Launch** — `tui_launch` to start the TUI app in a managed session +2. **Wait** — `tui_wait_for_idle` or `tui_wait_for_text` until app is ready +3. **Inspect** — `tui_snapshot` (accessibility tree) or `tui_text` (raw text) to read state +4. **Interact** — `tui_press_key`, `tui_send_text`, `tui_click` to drive the UI +5. **Assert** — `tui_screenshot` for visual verification or check `tui_text` output +6. **Cleanup** — `tui_close` to terminate the session + +## Key Concepts + +- **Accessibility snapshots** — structured element tree with references, preferred over raw text matching +- **Multi-session** — can run multiple TUI apps simultaneously for integration tests +- **Asciicast recording** — can record sessions for replay/debugging +- **JS scripting** — `tui_run_code` for complex programmatic interactions + +## File Location + +`/mnt/NV2/Development/claude-home/development/tui-testing.md`