UPTERM(1)

🦋 UPTERM(1) · upterm-session-wait · Upterm Manual 🦋

✨ NAME ✨

upterm-session-wait — wait for a session to end, bestie 💖

🌸 SYNOPSIS 🌸

upterm session wait NAME|ID [flags]

💅 DESCRIPTION 💅

Okay so this one waits for a session to end — you give it the session’s name or its session ID — and then it exits with that session’s outcome. Slay. ✨

NAME|ID is either the session’s name (the one upterm host printed, or the one --name gave it) or its session ID. upterm session list shows both, iykyk. 👑

If you give it a name, it waits for the session that holds that name when the wait starts. So let upterm host --detach return before you wait, just like in the example. If a session has already ended, it gets reported from its record — and upterm session list deletes that record once it is 7 days old. 🎀

Exit status follows the session, fr fr:

• 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. No cap. 💜

🎀 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)

📜 HISTORY 📜

2-Nov-2026 — Auto generated by spf13/cobra

---

That’s the whole vibe, bestie: Upterm 0.0.0+dev, Nov 2026, page UPTERM(1). Go wait on that session like the main character you are 💖✨