---
title: "tui in config.yaml"
url: https://devlanes.run/docs/reference/config/user/tui/
description: "Reference for the tui key in ~/.devlanes/config.yaml."
---

# tui in config.yaml

A top-level key of [`~/.devlanes/config.yaml`](/docs/reference/config/user/).

## `tui`

Type: mapping.

Whether start commands open the terminal UI, how it looks, and what quitting it does with running lanes.

```yaml devlanes-user
tui:
  open_on_start: false
```

### `tui.glyphs`

Type: string. Default: `auto`.

Characters the TUI draws states, markers and the spinner with; defaults to `auto`. Set `ascii` when your font shows boxes or misaligned symbols.

Values:

- `auto`: Unicode, or ASCII when the locale (the first of `LC_ALL`, `LC_CTYPE` and `LANG` that is set) is not UTF-8.
- `unicode`: Always Unicode symbols, such as ● ✕ ▾ and a braille spinner.
- `ascii`: Plain ASCII only, for fonts or terminals that draw Unicode symbols badly.

```yaml devlanes-user
tui:
  glyphs: auto
```

### `tui.on_quit`

Type: string. Default: `ask`.

What `q` or Ctrl+C does while lanes of the project on screen are running; defaults to `ask`. Ticking "remember" in the quit dialog writes the choice here.

Values:

- `ask`: Show a dialog each time to choose between keeping the lanes running and stopping them.
- `keep`: Close the TUI at once; every lane keeps running in the daemon.
- `stop`: Stop the running lanes of the project on screen, then close the TUI. Lanes of other projects keep running.

```yaml devlanes-user
tui:
  on_quit: ask
```

### `tui.open_on_start`

Type: boolean. Default: `true`.

Open the TUI for `start`, `restart`, `reload`, `lane resume` and `lane new --start` when they run at a terminal; defaults to true. Set false to have them print text instead, as `--no-ui` or `DEVLANES_NO_UI=1` do.

```yaml devlanes-user
tui:
  open_on_start: true
```

### `tui.theme`

Type: string. Default: `auto`.

Color palette of the TUI; defaults to `auto`, which picks one from what the terminal reports. Choose `dark` or `light` when auto guesses wrong; `NO_COLOR` in the environment turns colors off whatever this says.

Values:

- `auto`: Use the true-color dark or light palette when the terminal reports true color (`COLORTERM`) and its background (`COLORFGBG`); otherwise the terminal's 16 colors.
- `dark`: Always use the true-color palette made for a dark background.
- `light`: Always use the true-color palette made for a light background.
- `ansi`: Use only the terminal's 16 named colors, so the TUI follows the terminal's color scheme.

```yaml devlanes-user
tui:
  theme: auto
```
