Skip to content

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

terminal in config.yaml

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

Type: string or mapping.

Terminal integration of the CLI, written as a mapping with progress (the tab’s progress bar during starts). A plain string, the terminal app name older versions used, is still accepted but ignored with a warning.

~/.devlanes/config.yaml
terminal:
progress: auto

Type: string. Default: auto.

Whether service URLs, config error locations and log or bundle paths are clickable links (the OSC 8 sequence); defaults to auto, which writes them in iTerm2, kitty, WezTerm, Ghostty, Windows Terminal, VTE terminals, Konsole, Alacritty and foot. Elsewhere the same text prints without a link. DEVLANES_TERM_LINKS=0 or 1 overrides this setting.

Values:

  • auto: Only in terminals known to support it, on human output to a terminal; never inside tmux, screen, CI or a dumb terminal.
  • always: In every terminal, tmux included; a terminal without support may ignore it, or keep a title devlanes cannot put back.
  • never: Never use it.
~/.devlanes/config.yaml
terminal:
links: auto

Type: string. Default: auto.

Whether long command output (logs of several services, failed starts) marks where each section starts, so the terminal’s jump-to-mark or jump-to-prompt keys move between them; defaults to auto: marks in iTerm2, and prompt marks (OSC 133) in WezTerm, Ghostty, kitty, foot and Windows Terminal. DEVLANES_TERM_MARKS=0 or 1 overrides this setting.

Takes the same values as terminal.links.

~/.devlanes/config.yaml
terminal:
marks: auto

Type: string. Default: auto.

Whether a start that took a while finishing or failing, and a running service crashing, show a desktop notification while the terminal is not focused; defaults to auto. The TUI knows focus from the terminal; a command such as devlanes start does not, so with auto it notifies only in kitty, which itself skips a focused window. Terminals without notifications get the bell. At most one notification per 10 seconds. DEVLANES_TERM_NOTIFICATIONS=0 or 1 overrides this setting.

Takes the same values as terminal.links.

~/.devlanes/config.yaml
terminal:
notifications: auto

Type: string. Default: auto.

Whether starts show their progress in the terminal tab’s own progress bar (the OSC 9;4 sequence); defaults to auto. Only human output on a terminal gets it, and DEVLANES_TERM_PROGRESS=0 or 1 overrides this setting.

Values:

  • auto: Only in terminals known to draw it (Ghostty, WezTerm, iTerm2 3.6.6+, Windows Terminal, ConEmu, Ptyxis 48+, Konsole 26.04+); never inside tmux, screen, CI or a dumb terminal.
  • always: In every terminal, for ones auto does not recognize such as kitty; a terminal without support may ignore it or show it as text or a notification. Inside tmux it is passed through, which needs allow-passthrough on.
  • never: Never draw the progress bar.
~/.devlanes/config.yaml
terminal:
progress: auto

Type: string. Default: auto.

Whether the terminal tab’s title says what devlanes is doing (devlanes · acme@0 · starting 3/8 in the TUI, devlanes start acme@0 · 3/8 or devlanes logs -f api for long commands); defaults to auto. The previous title is saved on the terminal’s title stack and put back on exit, so auto sets it only where that stack exists: xterm, iTerm2, kitty, Ghostty and VTE terminals such as GNOME Terminal. Never inside tmux or screen, which manage titles themselves. DEVLANES_TERM_TITLE=0 or 1 overrides this setting.

Takes the same values as terminal.links.

~/.devlanes/config.yaml
terminal:
title: auto