pi-cozy-ui

A cozy UI for Pi — a minimal input box, startup screen, and cozy themes.

Inspirations:

• OpenCode input box
• Catppuccin color palette

Install

pi install npm:pi-cozy-ui

Then enable/disable modules in the resource config TUI:

pi config

Themes

The package includes two Catppuccin-inspired cozy themes that also style the thinking-level input border:

• cozy-dark — a soft Mocha-inspired dark palette
• cozy-light — a warm Latte-inspired light palette

Select either theme from /settings after installation.

Recommended settings

For the best experience:

1. Move pi-cozy-ui after packages that customize Pi's input or startup screen in pi config. If no other package customizes Pi's default input, place pi-cozy-ui at the top so the input loads sooner.
2. Select either cozy-dark or cozy-light from /settings.
3. Enable quiet startup to suppress Pi's default banner; the startup screen module replaces it with a cleaner centered header.

pi config

In the config TUI, set quietStartup to true. Or add it directly to ~/.pi/agent/settings.json:

{
	"quietStartup": true
}

Preview

Develop

pnpm install
pnpm dev
# = pi --no-extensions -e ./extensions/input-field.ts -e ./extensions/startup-screen.ts

Edit, then type /reload inside pi for live updates.

Layout

| File | Purpose | | ------------------------------ | -------------------------------------------------------------------- | | extensions/input-field.ts | Custom editor: left-bar input box with an embedded muted status row. | | extensions/startup-screen.ts | Startup header: centered ASCII "pi" icon and version. | | lib/text-layout.ts | Pure ANSI-aware text helpers used by both extensions. | | lib/editor-layout.ts | Pure composer for the minimal editor layout. | | themes/cozy-dark.json | Catppuccin-inspired dark theme. | | themes/cozy-light.json | Catppuccin-inspired light theme. |

Test

pnpm test

Type-check

pnpm check