Appearance
Pick a theme and an icon set
Two choices, made apart: the theme (colours) and the icons (the glyphs
uze draws its marks with). Both apply to the workspace and the CLI at once, and
both are also under management (Ctrl+O), on the Settings screen.
Theme
uze config theme list # the themes you can use
uze config theme set dracula # use oneBuilt in: dark (the default), light, dracula, catppuccin-mocha,
tokyo-night and tokyo-night-light. You can also
write your own.
Following your system
adaptive draws in a light theme while your system is light and a dark one
while it is dark, the way a page follows your system in a browser:
uze config theme set adaptive # light and dark
uze config theme set adaptive --light tokyo-night-light --dark draculaThe workspace reads the setting from Windows (also under WSL), macOS, or your Linux desktop, and switches when you change it, without restarting: at once on Windows and on a Linux desktop, within five seconds under WSL and on macOS, which have no way to announce the change. With no desktop to ask, as over SSH, it asks the terminal for its background when it opens instead. CLI commands draw in whatever the workspace saw last, and the dark theme until it has seen anything.
The agents in your panes see uze's own background when they ask theirs, so they follow along too.
Icons
Use a Nerd Font. uze is drawn for one: its icons come from a single patched font, at one weight, sized for the grid. Plain Unicode works, but most fonts borrow some of its marks from other families, and it shows.
Pick one of these, install it, set it as your terminal's font, then:
uze config icons nerd| Font | Download | Set your terminal to |
|---|---|---|
| JetBrains Mono | JetBrainsMono.zip | JetBrainsMono Nerd Font Mono |
| Fira Code | FiraCode.zip | FiraCode Nerd Font Mono |
| Cascadia Code | CascadiaCode.zip | CaskaydiaCove Nerd Font Mono |
| IBM Plex Mono | IBMPlexMono.zip | BlexMono Nerd Font Mono |
| Geist Mono | GeistMono.zip | GeistMono Nerd Font Mono |
| Commit Mono | CommitMono.zip | CommitMono Nerd Font Mono |
| Hack | Hack.zip | Hack Nerd Font Mono |
| Meslo | Meslo.zip | MesloLGS Nerd Font Mono |
| Iosevka | Iosevka.zip | Iosevka Nerd Font Mono |
| Source Code Pro | SourceCodePro.zip | SauceCodePro Nerd Font Mono |
Any family from the full catalog works. Two things matter:
- Choose the Mono name (
… Nerd Font Mono): its icons fill exactly one cell. The plain… Nerd Fontdraws them two cells wide. - Use Nerd Fonts v3 or newer. The icons uze draws do not exist in v2.
Installing one
mkdir -p ~/.local/share/fonts/JetBrainsMono
curl -fsSL https://github.com/ryanoasis/nerd-fonts/releases/latest/download/JetBrainsMono.zip -o /tmp/font.zip
unzip -o /tmp/font.zip -d ~/.local/share/fonts/JetBrainsMono
fc-cache -fWithout a Nerd Font
The default set uses plain Unicode and works everywhere, and ascii is for a
console with no Unicode at all. To compare them on your own terminal:
uze config icons # each set drawn in its own glyphs