.nh
.TH "UPTERM" "1" "Oct 2026" "Upterm 0.0.0+dev" "Upterm Manual"

.SH NAME
upterm-session-stop - Stop a running session


.SH SYNOPSIS
\fBupterm session stop NAME [flags]\fP


.SH DESCRIPTION
Stop a running session by name.

.PP
The session's command is hung up, then terminated, then killed if it stays,
and every attached terminal is released. The session's record keeps its
outcome: 'upterm session info NAME' reports it as stopped.

.PP
A session that has already ended is reported as such and is not an error.

.PP
Exits 4 when no session has the name, and 1 for any other failure.


.SH OPTIONS
\fB-h\fP, \fB--help\fP[=false]
	help for stop


.SH OPTIONS INHERITED FROM PARENT COMMANDS
\fB--debug\fP[=false]
	enable debug level logging (log file: /build/.upterm/upterm.log).


.SH EXAMPLE
.EX
  # Stop the session named build-shell:
  upterm session stop build-shell
.EE


.SH SEE ALSO
\fBupterm-session(1)\fP


.SH HISTORY
6-Oct-2026 Auto generated by spf13/cobra