| name | run-tui |
| description | Build and launch the TianWen.Cli TUI in a new Windows console window with stderr redirected to tui-stderr.log. Use when the user asks to run, launch, start, or open the TianWen TUI. |
The TUI takes over stdin/stdout for terminal rendering, so it cannot share the
current console with the agent. Launch it in a new Windows console window.
Run from the src/ directory. The cmd //c start wrapper asks the Windows
shell to spawn a detached console; cmd //k inside the new window keeps it
open after the TUI exits so the user can read any final stderr / stack trace
without it vanishing.
cd src && cmd //c start "TianWen TUI" cmd //k "dotnet run --project TianWen.Cli -- tui 2> tui-stderr.log"
Notes:
- Do not use
run_in_background: true — cmd //c start detaches the new
window itself and the parent Bash call returns immediately. The agent should
not try to stream the TUI's output back.
- The double-slashes (
//c, //k) are Git-Bash / MSYS mangling-protection so
the literal /c and /k flags reach cmd.exe instead of being rewritten to
Unix-style paths.
- Window title
"TianWen TUI" is also what start needs as its first
positional argument (Windows quirk when the first arg is quoted).
- After the user quits the TUI, check
src/tui-stderr.log for .NET exceptions
or terminal-capability diagnostics.
- Exit codes 127 / 13x from the TUI process mean the .NET process crashed (see
CLAUDE.md), not "command not found" — read tui-stderr.log first.