Skip to content

devlanes is in beta and not ready for production use.Report an issue

tui in config.yaml

A top-level key of ~/.devlanes/config.yaml.

Type: mapping.

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

~/.devlanes/config.yaml
tui:
open_on_start: false

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.
~/.devlanes/config.yaml
tui:
glyphs: auto

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.
~/.devlanes/config.yaml
tui:
on_quit: ask

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.

~/.devlanes/config.yaml
tui:
open_on_start: true

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.
~/.devlanes/config.yaml
tui:
theme: auto