pi-macos-theme-sync

Pi package that syncs Pi's theme with macOS light/dark appearance without polling

Packages

Package details

extension

Install pi-macos-theme-sync from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-macos-theme-sync
Package
pi-macos-theme-sync
Version
0.1.0
Published
May 26, 2026
Downloads
not available
Author
adstastic
License
MIT
Types
extension
Size
13 KB
Dependencies
0 dependencies · 1 peer
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

pi-macos-theme-sync

Pi extension that syncs Pi's theme with macOS light/dark appearance.

No polling. It watches macOS appearance notifications plus ~/Library/Preferences/.GlobalPreferences.plist changes via filesystem events, emits dark or light, then Pi calls ctx.ui.setTheme().

Install

From npm:

pi install npm:pi-macos-theme-sync

Try without installing:

pi -e npm:pi-macos-theme-sync

From this repository:

npm install
npm run build
pi -e ./src/index.ts

Or install/use it as a Pi package from a local path:

pi install /absolute/path/to/pi-macos-theme-sync

Use

Sync starts automatically on Pi session start.

Commands:

/pi-macos-theme-sync status
/pi-macos-theme-sync sync
/pi-macos-theme-sync debug
/pi-macos-theme-sync start
/pi-macos-theme-sync stop
/pi-macos-theme-sync restart

Default mapping:

  • macOS dark mode → Pi dark theme
  • macOS light mode → Pi light theme

Override theme names with env vars:

PI_MACOS_THEME_SYNC_DARK=tokyo-night \
PI_MACOS_THEME_SYNC_LIGHT=github-light \
pi -e ./src/index.ts

Requirements

  • macOS
  • Swift CLI available as swift (usually via Xcode Command Line Tools)
  • Pi interactive/RPC UI mode

Behavior

  • On startup, watcher emits current macOS appearance once.
  • On macOS appearance notification, watcher emits next mode.
  • On wake/unlock/screensaver stop, watcher re-emits current mode to catch scheduled changes that happened during sleep.
  • On .GlobalPreferences.plist filesystem change, extension re-reads current mode to catch flips when notifications do not reach Pi.
  • sync immediately re-reads macOS appearance and applies matching Pi theme.
  • debug reports macOS mode, Pi theme, Swift watcher PID, filesystem watcher count, and configured theme names.
  • Extension keeps a footer status like macOS:dark sync:on.
  • In non-macOS environments, extension no-ops with a warning.