hty attach

Bidirectional live connection to a running session: renders the session’s screen live and forwards every keystroke you type into the session. From the program’s perspective, your input is indistinguishable from any other client’s.

Multiple attach clients can be connected to the same session at the same time. All clients see the same screen and all clients can type.

Reference

hty attach [SESSION]

Interactively attach to a running session. Your terminal's keystrokes
are forwarded into the PTY and the session's rendered output streams
back — the same session an agent is driving can be taken over by a
human (or multiple humans) at any time.

Detach keybinds (tmux-style, Ctrl-A is the prefix):
  Ctrl-A d      Detach cleanly.
  Ctrl-A Ctrl-A Send a literal Ctrl-A to the session.

The observer's terminal size is sent on attach and on SIGWINCH, so
the child program sees the right LINES/COLUMNS.

Multiple clients can attach to the same session simultaneously —
writes are atomic per input frame, reads are broadcast to everyone.

Example


hty attach my-session

When multiple people are attached simultaneously, every keystroke from every client is sent to the program. There is no turn-taking or locking — if two people type at the same time, the program receives both streams interleaved.