@arhen/pi-senja
Senja Gruvbox Material theme with Haiku's structured header, footer, and live timer for Pi.
Package details
Install @arhen/pi-senja from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:@arhen/pi-senja- Package
@arhen/pi-senja- Version
1.2.5- Published
- Nov 19, 2026
- Downloads
- 501/mo · 342/wk
- Author
- arhen
- License
- MIT
- Types
- extension, theme
- Size
- 37.3 KB
- Dependencies
- 0 dependencies · 3 peers
Pi manifest JSON
{
"themes": [
"./themes/senja.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
@arhen/pi-senja
Senja theme and Haiku's tidier header and footer for Pi.
Forked from pi-haiku 0.2.0 by nocte, under MIT. The header/footer layout and behavior are preserved; branding, palette, and Pi 1.0 compatibility/safety fixes are the changes. Palette from Gruvbox Material by sainnhe, also MIT.
What's in it
- Gruvbox Material dark/medium/material — exact colors captured from Neovim, matching the Ghostty Senja theme. Background
#282828, foreground#d4be98, orange accent#e78a4e. All 56 Pi roles and HTML export backgrounds use palette variables. - A header with shortcuts grouped by control, models, view, and input.
- A footer with location, Git branch, session name, provider, model, thinking effort (including
max), context bar, token usage, latest cache-hit rate, cost, OAuth subscription marker, and extension statuses. - State-tinted tool panels — running tools use amber
#4f422e, successful tools the warm grey#32302f, failed tools maroon#4c3432. Your own messages sit one step brighter at#45403d, so a user turn, a finished tool block and the#282828page all read apart. - Quiet tool text — tool titles and output both use the foreground beige (
fg0) rather than loud accents, keeping panels calm against their tint. - Editor-style code colors — pink keywords, olive strings, aqua function names, amber types, warm beige identifiers and punctuation, readable muted comments. Applies to code in tool calls/results and Markdown code blocks through Pi's syntax roles.
- A live timer while Pi works, plus elapsed-time completion message and notification. Preserves the active mode label and colour from
@arhen/pi-add-mode(review is working... 8s). - Fast / Ultrafast mode —
/fast on|offand/ultrafast on|offset a paid speed preference per OpenAI provider and model. For ChatGPT sign-in, Senja checks the account’s model catalog before enabling or restoring a tier. If it is unavailable or cannot be verified, Senja warns and does not apply it. API-key mode checks known model support, not account entitlement. The footer shows onlyfastorultrafast. Only a different reported tier counts as amiss. A missing or unknown tier showstier not confirmedinstead. The badge stays on, and the next request still asks for the selected tier. Failed or canceled requests do not change the preference. Off shows no chip and adds no tier. Preferences persist under<agent-dir>/fast-mode/; explicitsamplingParams.service_tierstill wins. - A fresh start — clear the visible screen on initial terminal startup without clearing scrollback.
Enabled by default in terminal UI mode. Print, JSON, SDK, and RPC modes do not install terminal components, switch themes, clear the screen, or start UI timers. /senja in RPC mode reports that terminal UI is required.
Install
pi install npm:@arhen/pi-senja
Disable/remove pi-haiku or other header/footer replacements to avoid competing UI ownership.
Toggle
Type /senja to turn the header and footer on or off. The theme stays selected. Terminal session startup selects senja; selecting another theme afterward still works.
Development
From the monorepo root, with development dependencies available:
bun test packages/add/pi-senja/test
bunx tsc -p packages/add/pi-senja/tsconfig.json --noEmit
npm pack --dry-run --workspace @arhen/pi-senja
Tests use fake UI/session/timer handles, real Pi width utilities, and the current host theme loader when available. They do not open terminals or write user settings. Set SENJA_PI_HOST to an installed Pi coding-agent package directory to validate its theme schema and loader (for example, a Pi 1.0 installation).
License
MIT. Original 2026 nocte and Gruvbox Material 2020 sainnhe notices retained in LICENSE.