# Terminal User Interface

`rattler-build` offers a terminal user interface for building multiple packages and viewing the logs.

![rattler-build-tui](https://github.com/prefix-dev/rattler-build/assets/24392180/52138fd0-3c53-4028-a2c8-3099222c368a)

To launch the TUI, run the `build` command with the `--tui` flag as shown below:

```shell
$ rattler-build build -r recipe.yaml --tui
```

!!! note
    `rattler-build-tui` is gated behind the `tui` feature flag to avoid extra dependencies. Build the project with `--features tui` arguments to enable the TUI functionality.

#### Key Bindings

| Key                                                            | Action                                           |
| -------------------------------------------------------------- | ------------------------------------------------ |
| <kbd>⏎</kbd>                                                   | Build                                            |
| <kbd>a</kbd>                                                   | Build all                                        |
| <kbd>j</kbd>/<kbd>k</kbd>                                      | Next/previous package                            |
| <kbd>up</kbd>/<kbd>down</kbd>/<kbd>left</kbd>/<kbd>right</kbd> | Scroll logs                                      |
| <kbd>e</kbd>                                                   | Edit recipe (via `$EDITOR`)                      |
| <kbd>c</kbd>, <kbd>:</kbd>                                     | Open command prompt (available commands: `edit`) |
| <kbd>q</kbd>, <kbd>ctrl-c</kbd>, <kbd>esc</kbd>,               | Quit                                             |