pi-cmux-theme-picker
v0.3.0
Published
Live cmux terminal theme picker for Pi with synchronized pi + cmux theme switching and debounced preview.
Downloads
163
Maintainers
Readme
pi-cmux-theme-picker
Live cmux terminal theme picker for Pi. Synchronises Pi and cmux themes with debounced preview.

What it does
/theme— opens an inline picker to browse, filter, search, and live-preview all bundled cmux (Ghostty) themes. Confirm with Enter, cancel with Esc./theme "Theme Name"— apply a named theme directly without opening the picker./theme-settings— toggle extension settings (auto-sync on session start).- Auto-sync (opt-in) — reads the active cmux theme and generates a matching Pi theme on session start.
Install
pi install pi-cmux-theme-pickerUsage
/theme # Open the picker
/theme Catppuccin # Apply a theme directly by name
/theme-settings # Toggle auto-sync and other settingsPicker controls
| Key | Action |
|:---|:---|
| Up / Down | Navigate themes with live preview |
| Enter | Apply selected theme |
| Esc | Cancel and restore original |
| Tab | Cycle filter: all / dark / light |
| Type | Incremental search |
| Backspace | Delete search character |
Settings
| Setting | Default | Description | |:---|:---|:---| | Auto-sync on session start | off | Sync Pi theme from current cmux theme when a session starts |
How it works
- Reads cmux bundled Ghostty theme files from
/Applications/cmux.app/Contents/Resources/ghostty/themes/. - Converts the palette into a full Pi theme JSON (semantic colors, contrast-aware link picking, dark/light adaptation).
- Preview uses debounce + background prewrite — JSON file is written asynchronously;
setThemeandcmux themes setfire back-to-back with no I/O in between. - On confirm, writes a permanent
cmux-sync-{slug}.jsontheme file and cleans up old sync artifacts.
Requirements
- cmux installed at
/Applications/cmux.app - Pi with
@mariozechner/pi-coding-agentand@mariozechner/pi-tui
License
MIT
