pi-cc-header

Claude Code–style startup header for Pi. Animated Pi logo, 9-color palette, IBM stripes, Minecraft gradient, and a configurable info bar.

Maintained independently. Includes custom ASCII logos, random quote slogans, and an independent slogan color.

Install

pi install npm:@tenchi4u/pi-cc-header

Takes effect on next session or /reload.

If your Pi config is read-only (NixOS, declarative setup), set:

{ "ccHeader": { "readOnlyConfig": true } }

Visual changes still apply per-session but won't be persisted.

Features

• 14-frame Pi logo animation, speed any positive ms (presets: 25/30/35/40/45/50/75/100)
• 9-color palette: Anthropic orange, Clawd red, and more
• IBM-style horizontal stripes
• Minecraft-style pixel theme with 4-level 24-bit gradient
• Info bar: version, model, thinking level, skills, prompts, extensions, cwd, AGENTS.md marker
• Customizable slogan
• Custom ASCII logo (replace the final animation frame)
• Random quote slogan ("quote" + centered author, auto-rotated each startup)
• Independent slogan color (separate from the logo/header color; quote authors use a matching complementary color)

Commands

All flags under /pch:

Flag	Description	Effect
/pch --tg	Toggle header enable/disable	Next session
/pch --c [code]	Logo/header color (c/a/r/o/y/g/w/b/p); no arg = show current	Immediate
/pch --i	Toggle IBM stripes	Immediate
/pch --m	Toggle Minecraft gradient	Immediate
/pch --sp [ms]	Speed (any positive number; presets 25/30/35/40/45/50/75/100); no arg = show current	Immediate
/pch --v [all|pi|off]	Version label color; no arg = cycle	Immediate
/pch --ps	Toggle pkg skills count	Immediate
/pch --s [text]	Set slogan to literal text	Immediate
/pch --s	Toggle slogan on/off	Immediate
/pch --s -c [code]	Slogan color (same codes as --c); no code = toggle on/off	Immediate
/pch --s -d	Delete slogan	Immediate
/pch --s -quote	Pick a random quote as slogan; enables startup auto-rotation	Immediate
/pch --logo <l1|l2|...>	Set custom ASCII logo lines (pipe-separated)	Immediate
/pch --logo -d	Restore built-in Pi logo	Immediate
/pch --ml	Toggle model/thinking line	Immediate
/pch --df	Reset to defaults	Immediate
/pch --cl	Clear all config (pre-uninstall)	Immediate
/pch --h	Help	—

Slogan color

Slogan color is independent of the logo color and persisted as ccHeader.sloganColorCode.

/pch --s -c g        # green slogan text
/pch --s -c          # toggle slogan color on/off

The author name uses a complementary color chosen for the current slogan color; its ~ prefix remains muted gray.

Quotes

/pch --s -quote sets a random quote as the slogan in "quote" + author format. It also persists a quoteMode flag: while enabled, a new random quote is chosen on every startup.

Quotes are loaded from a quotes.json file. The package ships a default set of 71 quotes; you can override it by placing your own quotes.json in your project root (mirroring the array-of-objects shape below):

[
  { "quote": "You have power over your mind - not outside events. Realize this, and you will find strength.", "author": "Marcus Aurelius" }
]

Quotes over 10 words are split as evenly as possible across up to 2 lines, preferring a break at punctuation (. , : ; -). The author name is right-aligned to the end of the longest quote line, in the slogan color.

Custom ASCII logo

/pch --logo replaces the final animation frame with your own text/art (pipe-separated lines become rows). Lines may carry their own ANSI color.

/pch --logo  ████ | ▓▓▓▓ | ░░░░      # 3-line custom logo
/pch --logo -d                       # restore built-in Pi logo

Reset, disable, uninstall

• /pch --df — reset all settings to defaults. Does not preserve current config.
• /pch --tg — disable/re-enable. While disabled, all style commands are locked. Re-enabling takes effect next session.
• To uninstall cleanly: /pch --cl first, then pi uninstall npm:@tenchi4u/pi-cc-header.

Project additions

This project includes these additions:

Feature	Description	Command
Custom ASCII logo	Substitute final animation frame with your own art/text	/pch --logo
Random quote slogan	"quote" + centered author; auto-rotates each startup	/pch --s -quote
Independent slogan color	Slogan (and its author) colored separately from the logo	/pch --s -c <code>
quotes.json corpus	71 default quotes, overridable per-project	—

Scope notes:

• readOnlyConfig mode and the read-only write guards are inherited from upstream (not fork additions).
• This project ships a smaller, English-only README and no built-in asset images (logo art is code-generated).
• The core animation, palette, stripes, Minecraft gradient, and info-bar fields are unchanged from upstream.