pi-intro
v0.2.7
Published
A cinematic startup overlay and bottom spacer for Pi.
Readme
pi-intro
A cinematic startup overlay for Pi.

Try without installing
pi -e npm:pi-introThis runs the published package for the current Pi invocation without adding it to your project configuration.
Requirements
- Pi 0.80.7 or newer
Install
pi install npm:pi-introRestart Pi. The intro completes automatically, or press Escape to skip it.
What it does
- Lets Pi continue its remaining post-TUI startup work behind the overlay instead of blocking startup on the animation.
- Skips the overlay when Pi resumes a session through
--session,--continue, or--resume. - Starts at Pi's supported
session_starthook, so a brief normal Pi frame may appear first; initial extension and skill discovery has already completed.
Customization
Interactive: /pi-intro
Run /pi-intro inside Pi to pick a preset (or a custom word), then edit the bottom message in a prefilled editor — empty hides it. Enter persists immediately to ~/.pi/agent/pi-intro.json (no save key needed) and the intro replays as a live preview. The choice greets you when Pi starts without resuming a session; env vars below override the saved file when set.
Environment variables
Pick a preset with PI_INTRO_STYLE, or override the pieces with PI_INTRO_WORD, PI_INTRO_COLOR, and PI_INTRO_TAGLINE. Env vars override the saved ~/.pi/agent/pi-intro.json. Restart Pi after changing them.
Presets
| PI_INTRO_STYLE | Big word | Color |
| --- | --- | --- |
| (unset) / pi | PI | your theme's accent (default) |
| shopify | SHOPIFY | Shopify green #95BF47 |
| hacker | HACKER MODE | phosphor green #00DC41 |
| coffee | COFFEE TIME | espresso #C08051 |
| beast | BEAST MODE | rage red #E74C3C |
| prof | PROFESSOR | golden chalk #F1C40F |
| winter | WINTER IS COMING | ice blue #7FD4FF |
Custom presets also show WELCOME BACK under the big word, in your theme's muted color.
PI_INTRO_STYLE=shopify piCustom overrides
Overrides win over the preset. The word uses a built-in block font (A–Z, space, apostrophe); long words shrink to fit narrow terminals.
PI_INTRO_WORD=LEO PI_INTRO_COLOR=#0ea5e9 PI_INTRO_TAGLINE="BOM DIA" pi
PI_INTRO_STYLE=hacker PI_INTRO_WORD=ROOTED piInvalid hex colors fall back to your theme's accent.
Security and data access
Read SECURITY.md for private vulnerability reporting and docs/access.md for the package's exact file access. pi-intro starts no subprocesses and makes no direct network requests.
Development
node --experimental-strip-types --test tests/*.test.ts