@sageveil/pi

Sageveil TUI theme and statusline for Pi Coding Agent.

Packages

Package details

extensiontheme

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

npm repo home report

$ pi install npm:@sageveil/pi

Package: @sageveil/pi
Version: 0.2.2
Published: Jul 11, 2026
Downloads: 50/mo · 50/wk
Author: dgabka
License: MIT
Types: extension, theme
Size: 13.1 KB
Dependencies: 0 dependencies · 2 peers

Pi manifest JSON

{
  "extensions": [
    "./extensions"
  ],
  "themes": [
    "./themes"
  ]
}

Security note

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

README

@sageveil/pi

Overview

The sageveil Pi Coding Agent port provides a calm dark TUI theme and matching statusline. The statusline shows the repository root name (or current folder outside Git), Git branch and file-status counts, context usage, and active model. Statuses from other extensions appear on a separate line.

Get the theme

Install

npm install -g @sageveil/pi

Prebuilt releases

Download the theme from the dedicated repository: https://github.com/sageveil/pi.

You can also install the repository as a Pi package:

pi install git:github.com/sageveil/pi

Build from the monorepo

Install dependencies once: pnpm install
Render the theme: pnpm nx run pi:generate
The files land in dist/ports/pi/

Generated files

themes/sageveil.json – Pi theme file
extensions/sageveil-statusline.ts – matching statusline extension
package.json – Pi package manifest declaring both resources

Apply sageveil

Pi package

Install the package:

npm install -g @sageveil/pi
# or: pi install git:github.com/sageveil/pi

The statusline loads automatically. Select sageveil from /settings, or set it in ~/.pi/agent/settings.json:
```
{
  "theme": "sageveil"
}
```

Statusline

Reasoning models include the current thinking level beside the model name. To add cumulative token usage, cache statistics, and cost on a detail line, start Pi with:

SAGEVEIL_STATUSLINE=detailed pi

The default compact view omits that detail line and only shows context usage after it exceeds 75%.

Local theme file

Copy or symlink the generated theme and extension into Pi's global directories:

mkdir -p ~/.pi/agent/{extensions,themes}
cp dist/ports/pi/themes/sageveil.json ~/.pi/agent/themes/sageveil.json
cp dist/ports/pi/extensions/sageveil-statusline.ts ~/.pi/agent/extensions/sageveil-statusline.ts

Then select sageveil from /settings.

To load the generated file without installing it, pass it on startup and then select sageveil from /settings:

pi --theme dist/ports/pi/themes/sageveil.json

Development

sageveil/sageveil is the main project monorepo. All development happens there.

sageveil/pi is used only for easy distribution of the ready-to-use Pi Coding Agent colorscheme.