Terminal Emulators¶

dvt manages terminal emulator configurations as TerminalEmulator resources. You can apply, enable, disable, and install emulator configurations, and browse the built-in library of curated emulator configs.

Supported Emulators¶

Emulator	Type value	Platform
WezTerm	`wezterm`	macOS, Linux, Windows
Alacritty	`alacritty`	macOS, Linux, Windows
Kitty	`kitty`	macOS, Linux
iTerm2	`iterm2`	macOS only

WezTerm-specific commands

WezTerm has its own dedicated subcommand (dvt wezterm) with preset-based Lua generation. See WezTerm for details.

Commands¶

List emulator configurations¶

dvt emulator list

Filter by emulator type:

dvt emulator list --type wezterm
dvt emulator list --type alacritty
dvt emulator list --type kitty
dvt emulator list --type iterm2

Filter by category:

dvt emulator list --category minimal

Output as YAML or JSON:

dvt emulator list -o yaml
dvt emulator list -o json

Get a specific emulator configuration¶

dvt emulator get my-wezterm
dvt emulator get my-wezterm -o yaml

Enable an emulator configuration¶

Mark an emulator configuration as enabled:

dvt emulator enable my-wezterm

Disable an emulator configuration¶

dvt emulator disable my-wezterm

Install an emulator configuration¶

Install a named emulator configuration (writes the config file to the appropriate location):

dvt emulator install my-wezterm

Force overwrite an existing config:

dvt emulator install my-wezterm --force

Preview what would be installed without writing:

dvt emulator install my-wezterm --dry-run

Apply an emulator config from YAML¶

dvt emulator apply -f emulator.yaml

Preview without writing to the database:

dvt emulator apply -f emulator.yaml --dry-run

Emulator Library¶

The built-in library contains curated emulator configurations.

Browse the library¶

dvt emulator library list

Filter by type:

dvt emulator library list --type wezterm
dvt emulator library list --type alacritty

View a library entry¶

dvt emulator library show wezterm-minimal
dvt emulator library show wezterm-minimal -o yaml

YAML Format¶

apiVersion: devopsmaestro.io/v1
kind: TerminalEmulator
metadata:
  name: my-alacritty
  description: Alacritty configuration
  category: minimal
spec:
  type: alacritty
  font:
    family: "MesloLGS Nerd Font Mono"
    size: 14
  window:
    opacity: 0.95
    padding:
      x: 8
      y: 8
  colors:
    scheme: "Catppuccin Mocha"

WezTerm - WezTerm-specific Lua generation with presets
Terminal Packages - Bundle emulator config with prompts and plugins