Discovery commands
List sessions, tabs, panes, and clients or inspect one complete record as a table or JSON.
Every list and inspect command accepts --format table or --format json.
Table is the default.
List
koshi list-sessions
koshi list-tabs --session <NAME_OR_ID>
koshi list-panes --session <NAME_OR_ID>
koshi list-clients --session <NAME_OR_ID>| Command | Output |
|---|---|
list-sessions | Session ids and names |
list-tabs | Tab ids and names, and the id and name of the owning session |
list-panes | Pane, tab, and session ids and names |
list-clients | Client ids and owning sessions |
For scripts:
koshi list-panes --format jsonInspect
koshi inspect session <NAME_OR_ID>
koshi inspect tab <NAME_OR_ID>
koshi inspect pane <PANE_ID>
koshi inspect client <CLIENT_ID>inspect prints one full record. Add --format json for machine-readable
output. inspect pane shows a pane's command in full, arguments included.
Names and ids
Session and tab arguments take either the generated name or the printed id. An id is never re-read as a name. A name that several targets share is refused, and the error lists every matching id. Pane and client arguments take ids only.
Ending a session
koshi kill-session lives on Session commands,
beside attach and detach.
Reading running state
For the whole picture — every session's tabs, panes, and clients at once, or a
tab's solved rectangles — use
koshi debug.