---
name: "upterm-session-wait"
section: "1"
platform: "linux"
package: "upterm"
version: "0.40.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/upterm-session-wait"
---

# upterm-session-wait(1)

Wait for a session to end

## NAME

upterm-session-wait - Wait for a session to end

## SYNOPSIS

**upterm session wait NAME\|ID \[flags\]**

## DESCRIPTION

Wait for a session to end, given its name or session ID, and exit with its outcome.

NAME\|ID is the session's name (the one 'upterm host' printed, or --name gave it) or its session ID; 'upterm session list' shows both.

Given a name, it waits for the session that holds the name when it starts, so let 'upterm host --detach' return before you wait, as in the example. A session that has already ended is reported from its record, which 'upterm session list' deletes once it is 7 days old.

Exit status follows the session: its command's status when the command exited; 0 when it was stopped, or no guest joined within its join timeout; 128+N when the host or its command was killed by signal N; 125 when the outcome can't be known or read, when no session has the name, or for a usage or configuration error. A command can exit 125 too; 'upterm session info NAME -o json' has the reason. Ctrl-C stops waiting, with 130 on Unix, and leaves the session running.

## OPTIONS

**-h**, **--help**\[=false\]\
 	help for wait

## OPTIONS INHERITED FROM PARENT COMMANDS

**--debug**\[=false\]\
 	Enable debug logging (log file: /build/.upterm/upterm.log). A non-empty DEBUG turns it on too.

## EXAMPLE

```
  # Wait for a detached session and take its exit status:
  upterm host --detach --accept --name build -- make
  upterm session wait build
  # Wait for a session given its session ID:
  upterm session wait d3k5fia7m4us73ehblug
```

## SEE ALSO

**[upterm-session(1)](/upterm-session/1.md)**

## HISTORY

27-Oct-2026 Auto generated by spf13/cobra