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

# terminal in config.yaml

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

## `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.

```yaml devlanes-user
terminal:
  progress: auto
```

### `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.

```yaml devlanes-user
terminal:
  links: auto
```

### `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`](/docs/reference/config/user/terminal/#terminal-links).

```yaml devlanes-user
terminal:
  marks: auto
```

### `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`](/docs/reference/config/user/terminal/#terminal-links).

```yaml devlanes-user
terminal:
  notifications: auto
```

### `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 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.

```yaml devlanes-user
terminal:
  progress: auto
```

### `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`](/docs/reference/config/user/terminal/#terminal-links).

```yaml devlanes-user
terminal:
  title: auto
```
