wezterm cli list-clients
¶
Run wezterm cli list-clients --help
to see more help
Lists the set of connected clients and some additional information about them:
$ wezterm cli list-clients
USER HOST PID CONNECTED IDLE WORKSPACE FOCUS
wez foo 1098536 166.03140978s 31.40978ms default 0
The meanings of the fields are:
USER
- the username associated with the sessionHOST
- the hostname associated with the sessionPID
- the process id of the client sessionCONNECTED
- shows how long the connection has been establishedIDLE
- shows how long it has been since input was received from that clientWORKSPACE
- shows the active workspace for that sessionFOCUS
- shows the pane id of the pane that has focus in that session
Since: Version 20220624-141144-bd1b7c5d
The functionality described in this section requires version 20220624-141144-bd1b7c5d of wezterm, or a more recent version.
You may request JSON output:
$ wezterm cli list-clients --format json
[
{
"username": "wez",
"hostname": "foo",
"pid": 1098536,
"connection_elapsed": {
"secs": 226,
"nanos": 502667166
},
"idle_time": {
"secs": 0,
"nanos": 502667166
},
"workspace": "default",
"focused_pane_id": 0
}
]