terminal in config.yaml
A top-level key of ~/.devlanes/config.yaml.
terminal
Section titled “terminal”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.
terminal: progress: autoterminalTerminal 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.
terminal.progressWhether 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.
terminal.links
Section titled “terminal.links”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.
terminal: links: autoterminalTerminal 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.
terminal.linksWhether 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.
terminal.marks
Section titled “terminal.marks”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.
terminal: marks: autoterminalTerminal 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.
terminal.marksWhether 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.
terminal.notifications
Section titled “terminal.notifications”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.
terminal: notifications: autoterminalTerminal 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.
terminal.notificationsWhether 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.
terminal.progress
Section titled “terminal.progress”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 onesautodoes 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 needsallow-passthrough on.never: Never draw the progress bar.
terminal: progress: autoterminalTerminal 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.
terminal.progressWhether 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.
terminal.title
Section titled “terminal.title”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.
terminal: title: autoterminalTerminal 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.
terminal.titleWhether 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.