Terminal Support
Dynamo uses the Catppuccin Mocha color palette and Nerd Font glyphs for a polished terminal experience.
Recommended Terminals
| Terminal | Colors | Nerd Fonts | Notes |
|---|---|---|---|
| iTerm2 | 24-bit | Auto-detected | Recommended for macOS |
| Ghostty | 24-bit | Auto-detected | |
| Kitty | 24-bit | Auto-detected | |
| WezTerm | 24-bit | Auto-detected | |
| Alacritty | 24-bit | Auto-detected | |
| Windows Terminal | 24-bit | Auto-detected | |
| VS Code Terminal | 24-bit | Auto-detected | |
| macOS Terminal.app | 256-color | Manual override | Limited palette |
| tmux | 24-bit | Auto-detected | Needs set -g default-terminal "tmux-256color" |
Color Modes
- 24-bit true color — Full Catppuccin Mocha palette
- 256-color — Closest approximations (macOS Terminal.app)
- No color — Set
NO_COLOR=1to disable all colors
Nerd Fonts
Dynamo auto-detects Nerd Font support. Override with:
export DYNAMO_NERD_FONTS=1 # Force on
export DYNAMO_NERD_FONTS=0 # Force off (Unicode fallback)Tab Title & Focus
Dynamo updates your terminal's tab/window title to reflect its state, so you can tell what's happening from the tab strip without switching to it:
- idle — waiting for your input
- working — the model is responding or running tools
- attention — a prompt or question needs you (e.g. a permission approval)
Dynamo also tracks terminal focus, so the attention state is most useful when the tab is in the background. Title updates use standard terminal escape sequences and are harmless on terminals that don't support them.
> No inline images. Dynamo doesn't draw images in the terminal. When read_file opens an image it's sent to a vision-capable model for analysis, not rendered as pixels in your scrollback.
Troubleshooting
- Colors look wrong? — Check that your terminal supports true color
- No colors at all? — Your terminal might not report color support correctly. Try:
FORCE_COLOR=3 dynamo - Icons missing? — Install a Nerd Font or set
DYNAMO_NERD_FONTS=0 - Unicode broken? — Ensure your terminal uses UTF-8 encoding