@davehardy20/pi-theme-switcher

Pi package for switching TUI themes on the fly.

Packages

Package details

extension

Install @davehardy20/pi-theme-switcher from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@davehardy20/pi-theme-switcher
Package
@davehardy20/pi-theme-switcher
Version
0.1.0
Published
May 17, 2026
Downloads
not available
Author
davehardy20
License
MIT
Types
extension
Size
15.3 KB
Dependencies
0 dependencies · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

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

README

@davehardy20/pi-theme-switcher

Pi package for switching TUI themes on the fly.

What it adds

  • /theme — interactive theme picker
  • /theme <name> — switch directly to a named theme
  • /theme-status — show package name, version, source path, active theme, and available themes
  • Ctrl+Shift+T — cycle through themes
  • switch_theme tool — let Pi change the current theme without reloading
  • temporary theme swatch widget after a switch

Install

From git:

pi install git:github.com/davehardy20/pi-theme-switcher

From a local checkout during development:

pi install /Users/dave/tools/pi-theme-switcher

For one run only:

pi -e /Users/dave/tools/pi-theme-switcher

Notes

  • Theme switching is available only in the interactive TUI.
  • If commands appear twice, Pi is probably loading both this package and the old local agent/extensions/theme-switcher.ts file.
  • Disable or remove the old local auto-discovered extension before reload verification.

Update flow

  1. update the package repo
  2. push to GitHub
  3. run pi update --extensions or reinstall the package
  4. run /reload

/reload alone does not fetch newer package commits.

Troubleshooting

Run /theme-status to confirm:

  • package name
  • package version
  • loaded source path
  • active theme
  • visible theme list

Build and test

npm run typecheck
npm run test
npm run build