Skip to Content

hty kill

Send SIGKILL to a session’s process. The process is terminated immediately. By default the session record stays in the server — hty list continues to show it with status killed, and the log file is kept on disk so you can still hty logs or hty replay it. Pass --delete to also remove the record and log file in one shot.

Reference

hty kill [--delete] [SESSION]

Terminate a session's underlying process. The session RECORD stays in
place (same id, same name) so `hty list`, `hty logs` and `hty replay`
keep working on it — use `hty delete` to free the name and remove the
log file permanently.

If SESSION is omitted and exactly one session is running, that one
is killed.

Flags:
  --delete   After killing, also delete the session record and log
             file (equivalent to `hty kill` followed by `hty
             delete`). Useful for ad-hoc or test sessions whose
             recording you don't need to keep.

Examples

# Kill the process, keep the record and log file hty kill my-session # Kill and remove the record + log in one shot hty kill my-session --delete

hty kill is non-destructive by default. The log file is preserved after a kill, so hty logs and hty replay still work. Use hty kill --delete (or a later hty delete) when you’re done with the recording and want to free the name for reuse.

Last updated on