# Session tools

Session-scoped tools — enumerate windows, rename or kill a session, switch windows within it.

::::{grid} 1 2 2 3
:gutter: 2 2 3 3

:::{grid-item-card} {tooliconl}`list-windows`
Enumerate windows inside a session.
:::

:::{grid-item-card} {tooliconl}`get-session-info`
Read metadata for one session.
:::

:::{grid-item-card} {tooliconl}`select-window`
Switch to a window by id, index, or direction.
:::

:::{grid-item-card} {tooliconl}`create-window`
Create a new window inside a session.
:::

:::{grid-item-card} {tooliconl}`rename-session`
Rename an existing session.
:::

:::{grid-item-card} {tooliconl}`kill-session`
Terminate a session. Destructive.
:::

::::

```{toctree}
:hidden:
:maxdepth: 1

list-windows
get-session-info
select-window
create-window
rename-session
kill-session
```