@sageveil/pi

Overview

The sageveil Pi Coding Agent port provides a calm dark TUI theme and configurable matching statusline.

Get the theme

Install

pi install npm:@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

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

Generated files

• themes/sageveil.json – Pi theme file
• extensions/sageveil-statusline.ts – statusline extension entrypoint
• package.json – Pi package manifest declaring the extension entrypoint and theme

Apply sageveil

Pi package

1. Install the package:

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

2. Pi automatically loads the package's statusline extension and makes its theme available. Select sageveil from /settings, or set it in ~/.pi/agent/settings.json:

   {
     "theme": "sageveil"
   }
   

Statusline

Optional global settings live in ~/.pi/agent/sageveil.json:

{
  "statusline": {
    "icon": true,
    "directory": true,
    "gitBranch": true,
    "gitStatus": true,
    "context": "auto",
    "model": true,
    "usage": false,
    "extensionStatuses": true
  }
}

All fields are optional; omitted fields use these defaults.

The statusline fields only control visibility and retain their displayed order; there is no statusline.enabled setting. gitBranch and gitStatus are independent. icon controls the Pi icon; directory controls the repository root name (or current folder); model includes the thinking level for reasoning models; and extensionStatuses controls the separate extension-status line. usage shows cumulative input, output, cache, and cost details. context accepts true, false, or "auto": true always shows context usage, false never does, and "auto" shows it above 75%. Invalid known field types emit a warning and use their defaults; valid configured fields remain honored.

Local theme file

Copy or symlink the generated theme into Pi's global themes directory:

mkdir -p ~/.pi/agent/themes
cp dist/ports/pi/themes/sageveil.json ~/.pi/agent/themes/sageveil.json

Then select sageveil from /settings. Install @sageveil/pi to use its statusline; it requires the palette package.

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.