pi-nightfall-theme

A deep, low-glare Nightfall theme for Pi's TUI.

Compatibility

Nightfall is tested against Pi 0.84.1. Its package tooling supports Node.js 22.19.0 and newer, matching Pi 0.84.1's Node floor. The package contains no executable runtime code or runtime dependencies.

Pi 0.84's optional scrollbarThumb and thinkingMax colors are intentional: the fullscreen thumb uses a visible slate tone, while maximum thinking advances from pink to red.

Install

Install the published npm package through Pi:

pi install npm:pi-nightfall-theme

Or add it with npm when managing a package/project directly:

npm install pi-nightfall-theme

Git and local checkouts are also supported:

pi install git:github.com/Inv1x/pi-nightfall-theme
pi install /absolute/path/to/pi-nightfall-theme

Usage

Select nightfall from /settings, or set it in <agent-dir>/settings.json:

{
  "theme": "nightfall"
}

Theme

The package exposes one Pi theme:

• nightfall – deep navy backgrounds with cyan, lavender, and soft warm accents.

The theme references the checked-in Pi 0.84.1 schema snapshot, so local editor and CI validation do not rely only on the mutable upstream schema URL.

Development

npm ci
npm test
npm run pack:check

Automated checks validate required and unknown tokens, variable values and references, and HTML export fields. Before release, also complete the practical visual test matrix.

Versioning

Run npm run changeset for each user-facing change and commit the generated .changeset/*.md file. To prepare a release, run npm run release:status and then npm run release:version; Changesets consumes the pending files and updates package.json, package-lock.json, and CHANGELOG.md. These commands do not publish to npm or create a GitHub Release.