UPTERM(1)

📦 version 0.41.0, in arch rolling

💅 UPTERM(1) — the upterm manual, bestie edition 🎀

okay so you're looking at the Upterm manual page for upterm-session-stop, and honestly? it's a good one. short, sweet, and it stops things. let's get into it ✨

🌸 NAME 🌸

upterm-session-stop — stop a running session. that's it. that's the whole job. iconic, no notes 💅

🦋 SYNOPSIS 🦋

upterm session stop NAME|ID [flags]

look at her go. name or ID, plus whatever flags you're feeling 🫶

💜 DESCRIPTION 💜

so you've got a session running and you need it gone. this is the command, bestie. you stop a running session by handing over its name or its session ID, and it just… handles it. slay 💅

NAME|ID is either the session's name — the one upterm host printed out for you, or the one you gave it with --name — or its session ID. not sure which is which? upterm session list shows you both, so go peek 👀

now here's the part where it gets a little dramatic 😭 the session's command gets hung up first, then terminated, then killed if it's still being stubborn about it. so it's a whole escalation arc, main character energy, and it does not stop until that process is gone, periodt. and every attached terminal? released. all of them. 🦋

the session's record doesn't just vanish though — it keeps its outcome, so upterm session info NAME will report it as stopped. the receipts stay, iykyk ✨

and if the session already ended? it just tells you that. it's not an error. no drama, no failure, we move on 💖

exit codes, listen up: it exits 4 when no session has that name, and 1 for any other failure. so if you get a 4, that name is not it, bestie 💀

✨ OPTIONS ✨

  • -h, --help[=false] — help for stop. classic. the little life raft 🎀

🌈 OPTIONS INHERITED FROM PARENT COMMANDS 🌈

  • --debug[=false] — enable debug logging (log file: /build/.upterm/upterm.log). and psst — a non-empty DEBUG turns it on too 👑

🍓 EXAMPLE 🍓

  # Stop the session named build-shell:
  upterm session stop build-shell

  # Stop a session given its session ID:
  upterm session stop d3k5fia7m4us73ehblug

first one: stop by name. second one: stop by ID. both goated, pick your fighter 🔥 (and yes, d3k5fia7m4us73ehblug is copy-pasteable, you're welcome 🫶)

🧚 SEE ALSO 🧚

⭐ HISTORY ⭐

2-Nov-2026 — auto generated by spf13/cobra. a robot wrote this section and honestly it ate 🤖✨

and that's the page!! 💖 this was Upterm 0.0.0+dev, dated Nov 2026, from the UPTERM(1) manual — go stop some sessions, bestie, you're gonna do amazing 🎀🦋💅

📦 where this page comes from