docs: add terminal requirements (#708)

This commit is contained in:
Tommy 2025-07-08 15:30:05 -05:00 committed by GitHub
parent 14d81e574b
commit 9ed187ee52
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -9,6 +9,18 @@ By default, opencode uses our own `opencode` theme.
---
## Terminal requirements
For themes to display correctly with their full color palette, your terminal must support **truecolor** (24-bit color). Most modern terminals support this by default, but you may need to enable it:
- **Check support**: Run `echo $COLORTERM` - it should output `truecolor` or `24bit`
- **Enable truecolor**: Set the environment variable `COLORTERM=truecolor` in your shell profile
- **Terminal compatibility**: Ensure your terminal emulator supports 24-bit color (most modern terminals like iTerm2, Alacritty, Kitty, Windows Terminal, and recent versions of GNOME Terminal do)
Without truecolor support, themes may appear with reduced color accuracy or fall back to the nearest 256-color approximation.
---
## Built-in themes
opencode comes with several built-in themes.