@benvargas/pi-themes

Theme collection for pi

Packages

Package details

theme

Install @benvargas/pi-themes from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@benvargas/pi-themes
Package
@benvargas/pi-themes
Version
1.2.0
Published
Aug 11, 2026
Downloads
118/mo · 13/wk
Author
benvargas
License
MIT
Types
theme
Size
20.2 KB
Dependencies
0 dependencies · 0 peers
Pi manifest JSON
{
  "themes": [
    "./themes"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@benvargas/pi-themes

A collection of themes for pi.

Included Themes

Theme Appearance Description
github-light-default Light GitHub Light Default-inspired interface, Markdown, tool, diff, syntax, and thinking-level colors
mono-black Dark Strict monochrome theme with a black background and grayscale surfaces
mono-light Light Strict monochrome theme with a white background and grayscale surfaces
orng-light Light Adaptation of OpenCode's warm orange Orng theme

Install

pi install npm:@benvargas/pi-themes

Or try it without installing:

pi -e npm:@benvargas/pi-themes

For local development from this repository:

pi -e ./packages/pi-themes

Select a Theme

Choose an installed theme from /settings, or set its name in ~/.pi/agent/settings.json:

{
  "theme": "github-light-default"
}

GitHub Light Default

github-light-default is designed for a terminal with a light background, ideally #ffffff or #f6f8fa. Pi does not set the terminal's full background, so dark terminal profiles will not display this theme correctly.

Its palette is adapted from the MIT-licensed GitHub VS Code theme by Primer. The pi token mapping was designed as a light companion to Benjamin Davis's github-dark-default theme.

This project is not affiliated with or endorsed by GitHub.

Orng Light

orng-light adapts the light variant of OpenCode's built-in Orng theme. It preserves the orange, blue, cyan, red, gold, and warm neutral palette while mapping OpenCode's interface, Markdown, syntax, and diff roles to pi's theme tokens.

The original Orng theme was created by Matt Silverlock and is distributed with OpenCode under the MIT license. This adaptation uses a darker recurring muted-text color for readability while retaining Orng's original #8a8a8a for deliberately dim content such as comments.

Like the other light theme, orng-light expects a terminal with a light background.

Mono Black and Mono Light

mono-black and mono-light are strict monochrome themes: every interface, Markdown, diff, syntax, and thinking-level token maps to black, white, or a shade of gray. They are adapted from Kartik Kabadi's MIT-licensed pi-mono-themes.

Each theme can be selected individually. With pi 0.84.0 or newer, they can also follow the terminal's detected color scheme automatically:

{
  "theme": "mono-light/mono-black"
}

Pi checks the terminal color-scheme or background response and falls back to the dark theme when detection is unavailable. These packaged adaptations also provide visible fullscreen scrollbar colors and explicit monochrome colors for HTML session exports.

Versioning

This package follows Semantic Versioning. See CHANGELOG.md for release history.

Uninstall

pi remove npm:@benvargas/pi-themes

License

MIT. See THIRD_PARTY_NOTICES.md for third-party theme licenses and attributions.