omp packages

pi-intro0.2.7

A cinematic startup overlay and bottom spacer for Pi.

GitHub Actions Published 24 days ago MIT ~267 downloads/mo

Untested on omp

This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.

Did it work for you?

Result

One report per person. A new report replaces your old one.

Reports 0

No reports yet.

Readme

pi-intro

A cinematic startup overlay for Pi.

pi-intro demo

Try without installing

pi -e npm:pi-intro

This 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-intro

Restart 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_start hook, 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 pi

Custom 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 pi

Invalid 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