Themes
aibox supports consistent color theming across all terminal tools. Set a theme in aibox.toml:
[customization]
theme = "gruvbox-dark"
mode = "auto"
Or during project initialization:
aibox init --theme catppuccin-mocha
The selected theme is applied to tmux, Vim, Yazi, lazygit, and Starship simultaneously.
mode = "auto" follows the host OS light/dark appearance when a host signal is detectable during aibox apply, aibox up, or aibox set theme.*. Containers do not receive live macOS/Windows/Linux appearance-change events, so rerun one of those commands to regenerate mounted runtime theme files after changing the host appearance. If the host appearance cannot be detected, auto preserves the selected concrete theme.
mode = "light" and host-light auto use the selected theme family's light partner when one exists. Genuinely dark-only themes stay on the selected concrete theme instead of falling back to an unrelated light theme.
Available Themes
aibox supports the tmux-powerkit popular theme roster plus aibox-specific extensions:
tokyo-night,tokyo-night-storm,tokyo-night-daycatppuccin-mocha,catppuccin-macchiato,catppuccin-frappe,catppuccin-lattedracula,dracula-soft,nord,gruvbox-dark,gruvbox-lightrose-pine,rose-pine-moon,rose-pine-dawnmaterial,material-ocean,material-palenight,material-lighter,material-darkersolarized-dark,solarized-lightgithub-dark,github-dark-dimmed,github-dark-high-contrast,github-light,github-light-high-contrastayu-dark,ayu-mirage,ayu-light,night-owl,night-owl-light,moonlighteverforest-dark,everforest-light,kanagawa-wave,kanagawa-dragon,kanagawa-lotusmin-dark,min-light,one-dark-pro,one-light,slack-dark,slack-ochinvitesse-dark,vitesse-light,vitesse-black,vscode-dark-plus,vscode-light-plusandromeeda,aurora-x,houston,laserwave,monokai,plastic,poimandres,red,snazzy-light,synthwave-84,vesperprojectious
Light/Dark Partners
| Family | Dark variants | Light variant |
|---|---|---|
| Tokyo Night | tokyo-night, tokyo-night-storm | tokyo-night-day |
| Catppuccin | catppuccin-mocha, catppuccin-macchiato, catppuccin-frappe | catppuccin-latte |
| Gruvbox | gruvbox-dark | gruvbox-light |
| Rose Pine | rose-pine, rose-pine-moon | rose-pine-dawn |
| Material | material, material-ocean, material-palenight | material-lighter |
| Solarized | solarized-dark | solarized-light |
| GitHub | github-dark | github-light |
| Ayu | ayu-dark, ayu-mirage | ayu-light |
| Night Owl | night-owl | night-owl-light |
| Everforest | everforest-dark | everforest-light |
| Kanagawa | kanagawa-wave, kanagawa-dragon | kanagawa-lotus |
| Min | min-dark | min-light |
| One Dark | one-dark-pro | one-light |
| Slack | slack-dark | slack-ochin |
| Vitesse | vitesse-dark, vitesse-black | vitesse-light |
| VS Code | vscode-dark-plus | vscode-light-plus |
Dark-only or single-variant themes with no light partner: andromeeda,
aurora-x, houston, laserwave, monokai, moonlight, nord, plastic,
poimandres, projectious, red, snazzy-light, synthwave-84, and vesper.
gruvbox-dark (default)
Retro groove color scheme with warm, earthy tones. High contrast and easy on the eyes.
- Background:
#282828(dark brown-gray) - Accent:
#D79921(warm yellow) - Style: Dark, warm, retro
catppuccin-mocha
Soothing pastel theme with a dark background. The most popular modern terminal theme.
- Background:
#1E1E2E(deep purple-black) - Accent:
#89B4FA(soft blue) - Style: Dark, pastel, modern
catppuccin-latte
Light variant of Catppuccin. Clean and readable in bright environments.
- Background:
#EFF1F5(warm white) - Accent:
#1E66F5(vivid blue) - Style: Light, pastel, modern
dracula
Dark theme with vibrant colors. A classic among developers.
- Background:
#282A36(dark gray-blue) - Accent:
#BD93F9(purple) - Style: Dark, vibrant, bold
tokyo-night
Inspired by Tokyo's night lights. Clean and modern with blue tones.
- Background:
#1A1B26(deep blue-black) - Accent:
#7AA2F7(bright blue) - Style: Dark, cool, modern
nord
Arctic, north-bluish color palette. Minimalist and calm.
- Background:
#2E3440(dark blue-gray) - Accent:
#88C0D0(frost blue) - Style: Dark, cool, minimalist
projectious
The projectious.work brand theme. Deep navy base with a vivid orange accent.
- Background:
#1d3352(midnight navy) - Accent:
#E05232(ember orange) - Midtone:
#546a82(slate blue) - Style: Dark, professional
How It Works
Each theme is a coordinated set of config files applied to all tools when aibox apply, aibox up, or aibox set theme.* regenerates managed runtime files:
| Tool | Config file | What's themed |
|---|---|---|
| tmux | .config/tmux/themes/<name>.conf | Pane borders, status bar, window colors |
| Vim | .vim/colors/<name>.vim | Syntax highlighting, UI elements |
| Yazi | .config/yazi/theme.toml | File colors, status bar, selection |
| lazygit | .config/lazygit/config.yml | Borders, selection, diff colors |
| Starship | .config/starship.toml | Prompt segment colors |
Claude Code inherits terminal colors automatically — no separate theme file needed.
Changing Themes
To switch light/dark mode in an existing project:
aibox set theme.mode auto
aibox set theme.mode light
aibox set theme.mode dark
aibox set theme.name tokyo-night
This updates [customization].mode in aibox.toml and regenerates the mounted runtime theme files under .aibox-home/. The running container is not stopped.
If the project tmux session is running, refresh and attach it without stopping the container:
aibox set theme.mode dark --restart-session
aibox apply and aibox set theme.mode/name overwrite theme-dependent config files (tmux theme, Vim colorscheme, Yazi theme, lazygit config, Starship config) to match the selected theme. You do not need to rebuild or restart the container to change themes; running TUI processes may need to be restarted.