upterm session list
List running sessions
Synopsis
List the running sessions, one row each: name, status, session ID, command and relay. * marks the session this terminal is in ($UPTERM_ADMIN_SOCKET).
The sessions come from the records in: /home/user/.local/state/upterm/results Sessions started under another XDG_RUNTIME_DIR are listed too. Listing deletes the records of sessions that ended more than 7 days ago, after which ‘upterm session info’ and ‘upterm session wait’ no longer know them.
-o json prints a JSON array of what ‘upterm session info NAME -o json’ prints, one per running session, and [] when none is running.
Exit status: 0, or 1 when the records directory can’t be read, or for a usage or configuration error. A session whose own record can’t be read is left out of the list.
upterm session list [flags]
Examples
# List the running sessions:
upterm session list
# As JSON, for a script:
upterm session list -o json
Options
-h, --help help for list
--hide-client-ip Hide guests' IP addresses from upterm's output. When it isn't set (by flag, environment or config file), they are hidden in CI only; --hide-client-ip=false shows them there too.
-o, --output string Output format: json (command line only)
Options inherited from parent commands
--debug Enable debug logging (log file: /home/user/.local/state/upterm/upterm.log). A non-empty DEBUG turns it on too.
SEE ALSO
- upterm session - Display and manage terminal sessions