# libtmux.Pane.choose_tree

- **Module:** libtmux
- **Package:** libtmux
- **Language:** Python
- **Kind:** method
- **Source:** https://github.com/tmux-python/libtmux/blob/38e368c11117fb4aeb2f082d552cd4f210eae06a/src/libtmux/pane.py#L2085
- **Page:** https://libtmux.org/en/py/stable/reference/libtmux-pane-choose_tree/

tmux command: [`choose-tree`](/en/tmux/latest/manual/choose-tree/)

```
libtmux.Pane.choose_tree(
    self,
    sessions_collapsed: bool | None = None,
    windows_collapsed: bool | None = None,
    format_string: str | None = None,
    filter_expression: str | None = None,
    sort_order: t.Literal["index", "name", "time", "size"]
    | None = None,
    reverse: bool | None = None,
    zoom: bool | None = None,
) -> None
```

Enter tree chooser via [`$ tmux choose-tree`](/en/tmux/latest/manual/choose-tree/).

## Examples

```python
>>> pane.choose_tree()
```

## Parameters

- `sessions_collapsed` (`bool | None`): Start with sessions collapsed (``-s`` flag).
- `windows_collapsed` (`bool | None`): Start with windows collapsed (``-w`` flag).
- `format_string` (`str | None`): Format for each item shown in the chooser (``-F`` flag).
- `filter_expression` (`str | None`): Filter expression evaluated per item; only items whose
filter expands non-zero are shown (``-f`` flag).
- `sort_order` (`t.Literal["index", "name", "time", "size"] | None`): Sort field (``-O`` flag).
- `reverse` (`bool | None`): Reverse the sort order (``-r`` flag).
- `zoom` (`bool | None`): Zoom the pane while the chooser is active (``-Z`` flag).

## In other ports

### Open the session and window chooser in a pane

- TypeScript: [`pane.Pane.chooseTree`](/en/ts/latest/reference/pane-pane-choosetree/) (method)
- Go: [`tmux.Pane.ChooseTree`](/en/go/latest/reference/tmux-pane-choosetree/) (method)
- C#: [`LibTmux.Pane.ChooseTreeAsync`](/en/csharp/latest/reference/libtmux-pane-choosetreeasync/) (method)