Skip to Content

hty watch

Connect to a running session and render its terminal screen in real time inside your terminal. Strictly read-only — you cannot send input.

Multiple terminals can watch the same session simultaneously without any coordination required.

Reference

hty watch [SESSION]

Attach to a session read-only and paint its rendered screen live to
your terminal. Ctrl-C or Ctrl-Q to detach.

SESSION may be a UUID prefix or the session's --name. If omitted and
exactly one session is running, that one is used.

Example

# Terminal A: start the program hty run --name demo -- vim /tmp/notes.txt # Terminal B: observe it live hty watch demo

Use hty watch in CI to stream session output to your build log while your script drives the session with hty send and hty wait. Because watch makes no changes, it is safe to run in parallel with any automation.

Last updated on