strix/docs/usage
Ahmed Allam 1ee5c2bcc6 fix(cli): run headless when no terminal is attached instead of crashing the TUI
Without a tty on stdin and stdout (CI, nohup, pipes, cron, TERM=dumb) the Go
TUI handshakes fine and then exits 1 the moment Bubble Tea tries to take over
the screen. Because the backend was already activated, that exit escaped the
pre-activation mapping and surfaced as a raw traceback:
RuntimeError: Bubble Tea TUI exited with status 1.

Now main() checks for a terminal right after argument parsing. With a target
it switches to the headless path (same as -n) and prints one dim notice.
Without a target the start screen is the only way to enter one, so it prints
a panel telling the user to pass -t <target> -n and exits 1. A bare --resume
is left to the picker, which already lists runs when there is no terminal.

If the sidecar still dies after startup, check_return_code raises
TuiProcessExitedError, run_tui maps it to InteractiveInterfaceExitedError,
and main() prints an INTERACTIVE INTERFACE STOPPED panel with the -n hint
under its own telemetry name instead of re-raising.
2026-10-05 00:37:27 +03:00
..
cli.mdx fix(cli): run headless when no terminal is attached instead of crashing the TUI 2026-10-05 00:37:27 +03:00
instructions.mdx fix(runtime): place extra files as agent-writable sandbox files on every backend 2026-09-17 21:53:35 +03:00
scan-modes.mdx feat: Better source-aware testing (#391) 2026-03-31 11:53:49 -07:00
viewer.mdx docs: note viewer steering, history, and report prerequisites 2026-09-02 18:35:45 +03:00