https://github.com/dive/modus-themes-ports
Modus theme ports for the tools in my workflow (Ghostty, Yazi, FZF, bat & others)
https://github.com/dive/modus-themes-ports
color-scheme themepack themes-css
Last synced: 2 months ago
JSON representation
Modus theme ports for the tools in my workflow (Ghostty, Yazi, FZF, bat & others)
- Host: GitHub
- URL: https://github.com/dive/modus-themes-ports
- Owner: dive
- License: mit
- Created: 2026-02-03T09:11:07.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-02-28T06:49:05.000Z (3 months ago)
- Last Synced: 2026-03-02T02:37:02.855Z (3 months ago)
- Topics: color-scheme, themepack, themes-css
- Language: Go Template
- Homepage:
- Size: 5.2 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Modus Themes Ports
[](LICENSE)
[](https://www.python.org/)
Ports of the [Modus themes](https://protesilaos.com/emacs/modus-themes) for terminal tools.
Modus themes are designed by [Protesilaos Stavrou](https://protesilaos.com/about/) with a focus on accessibility—conforming to the highest legibility standard (WCAG AAA). They ship in light/dark variants with tinted and color-deficiency friendly flavors (deuteranopia, tritanopia).
## Supported Tools
| Tool | Description |
|------|-------------|
| [Amp](ports/amp/README.md) | AI coding agent CLI |
| [bat](ports/bat/README.md) | Cat clone with syntax highlighting |
| [Glamour](ports/glamour/README.md) | Markdown style JSON format |
| [Glow](ports/glow/README.md) | Markdown previewer |
| [Ghostty](ports/ghostty/README.md) | Terminal emulator |
| [Helix](ports/helix/README.md) | Modal text editor |
| [Lazygit](ports/lazygit/README.md) | Terminal UI for git |
| [LS_COLORS](ports/ls-colors/README.md) | Colors for `ls` and compatible tools |
| [OpenCode](ports/opencode/README.md) | AI coding agent CLI |
| [Pi](ports/pi/README.md) | AI coding agent CLI |
| [tmux](ports/tmux/README.md) | Terminal multiplexer |
| [Visual Studio Code](ports/vscode/README.md) | Code editor |
| [Xcode](ports/xcode/README.md) | Apple IDE |
| [Yazi](ports/yazi/README.md) | Terminal file manager |
| [Zed](ports/zed/README.md) | Code editor |
Screenshots: [SCREENSHOTS.md](SCREENSHOTS.md)
## Quick Start
```sh
# List available tools and themes
python3 scripts/modus.py list
# Install themes for a tool (creates symlinks)
python3 scripts/modus.py install --tool ghostty
# Install a specific theme
python3 scripts/modus.py install --tool ghostty --theme modus-operandi
```
Themes are symlinked into `$XDG_CONFIG_HOME` by default. See each tool's README for activation instructions.
## Theme Variants
| Variant | Light | Dark |
|---------|-------|------|
| Default | `modus-operandi` | `modus-vivendi` |
| Tinted backgrounds | `modus-operandi-tinted` | `modus-vivendi-tinted` |
| Deuteranopia (red-green) | `modus-operandi-deuteranopia` | `modus-vivendi-deuteranopia` |
| Tritanopia (blue-yellow) | `modus-operandi-tritanopia` | `modus-vivendi-tritanopia` |
## Accent Hue Reference
Preview of the core accent foreground hues by variant (base, warmer, cooler, faint, intense).
> [!NOTE]
> This repo uses the Modus faint preset by default for palette extraction.
Docs: [Modus palette overrides](https://protesilaos.com/emacs/modus-themes#h:34c7a691-19bb-4037-8d2f-67a07edab150)
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md) to add new ports—no-code templates supported.
## Credits
All credit for the Modus themes design goes to [Protesilaos Stavrou](https://protesilaos.com/about/). This project ports his work to additional tools.
- Upstream repository: [protesilaos/modus-themes](https://github.com/protesilaos/modus-themes)
- Manual: [Modus Themes Manual](https://protesilaos.com/emacs/modus-themes)
## License
MIT