Skip to content

Quick Start

Get your terminal configured with dvt in minutes.

1. Initialize

Create the dvt config directory:

dvt init

2. Browse the Prompt Library

See available built-in prompts:

dvt prompt library list

Filter by category:

dvt prompt library list -c minimal

View details for a specific prompt:

dvt prompt library show starship-minimal

3. Install a Prompt

Install a prompt from the library into your local database:

dvt prompt library install starship-minimal

Install multiple prompts at once:

dvt prompt library install starship-minimal starship-powerline

4. Apply a Prompt from YAML

Create a custom prompt definition:

# my-prompt.yaml
apiVersion: devopsmaestro.io/v1
kind: TerminalPrompt
metadata:
  name: my-prompt
  description: My custom Starship prompt
spec:
  type: starship
  addNewline: true
  palette: theme
  format: "$directory$git_branch$character"
  modules:
    directory:
      format: "[$path]($style) "
      style: "${theme.primary}"
    git_branch:
      symbol: " "
      format: "[$symbol$branch]($style) "
      style: "${theme.accent}"
    character:
      successSymbol: "[>](bold ${theme.success})"
      errorSymbol: "[>](bold ${theme.error})"

Apply it:

dvt prompt apply -f my-prompt.yaml

5. Generate a Config File

Generate starship.toml from a saved prompt:

dvt prompt generate my-prompt

6. Set the Active Prompt

Mark a prompt as active:

dvt prompt set my-prompt

7. Configure WezTerm

Browse built-in WezTerm presets:

dvt wezterm list

Preview a preset:

dvt wezterm show minimal

Apply a preset to generate wezterm.lua:

dvt wezterm apply minimal

Next Steps