@tenchi4u/pi-cc-header 1.0.0 → 1.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +115 -115
  2. package/extensions/pi-cc-header.ts +1471 -1426
  3. package/package.json +54 -54
  4. package/quotes.json +286 -72
package/README.md CHANGED
@@ -1,115 +1,115 @@
1
- # pi-cc-header
2
-
3
- Claude Code–style startup header for [Pi](https://pi.dev). Animated Pi logo, 9-color palette, IBM stripes, Minecraft gradient, and a configurable info bar.
4
-
5
- Maintained independently. Includes custom ASCII logos, random quote slogans, and an independent slogan color.
6
-
7
- ## Install
8
-
9
- ```bash
10
- pi install npm:@tenchi4u/pi-cc-header
11
- ```
12
-
13
- Takes effect on next session or `/reload`.
14
-
15
- If your Pi config is read-only (NixOS, declarative setup), set:
16
-
17
- ```json
18
- { "ccHeader": { "readOnlyConfig": true } }
19
- ```
20
-
21
- Visual changes still apply per-session but won't be persisted.
22
-
23
- ## Features
24
-
25
- - 14-frame Pi logo animation, speed 25/50/75/100 ms
26
- - 9-color palette: Anthropic orange, Clawd red, and more
27
- - IBM-style horizontal stripes
28
- - Minecraft-style pixel theme with 4-level 24-bit gradient
29
- - Info bar: version, model, thinking level, skills, prompts, extensions, cwd, AGENTS.md marker
30
- - Customizable slogan
31
- - **Custom ASCII logo** (replace the final animation frame)
32
- - **Random quote slogan** (`"quote"` + centered author, auto-rotated each startup)
33
- - **Independent slogan color** (separate from the logo/header color)
34
-
35
- ## Commands
36
-
37
- All flags under `/pch`:
38
-
39
- | Flag | Description | Effect |
40
- |------|-------------|--------|
41
- | `/pch --tg` | Toggle header enable/disable | Next session |
42
- | `/pch --c [code]` | Logo/header color (`c/a/r/o/y/g/w/b/p`); no arg = show current | Immediate |
43
- | `/pch --i` | Toggle IBM stripes | Immediate |
44
- | `/pch --m` | Toggle Minecraft gradient | Immediate |
45
- | `/pch --sp [ms]` | Speed (`25/50/75/100`); no arg = show current | Immediate |
46
- | `/pch --v [all\|pi\|off]` | Version label color; no arg = cycle | Immediate |
47
- | `/pch --ps` | Toggle pkg skills count | Immediate |
48
- | `/pch --s [text]` | Set slogan to literal text | Immediate |
49
- | `/pch --s` | Toggle slogan on/off | Immediate |
50
- | `/pch --s -c [code]` | Slogan color (same codes as `--c`); no code = toggle on/off | Immediate |
51
- | `/pch --s -d` | Delete slogan | Immediate |
52
- | `/pch --s -quote` | Pick a random quote as slogan; enables startup auto-rotation | Immediate |
53
- | `/pch --logo <l1\|l2\|...>` | Set custom ASCII logo lines (pipe-separated) | Immediate |
54
- | `/pch --logo -d` | Restore built-in Pi logo | Immediate |
55
- | `/pch --ml` | Toggle model/thinking line | Immediate |
56
- | `/pch --df` | Reset to defaults | Immediate |
57
- | `/pch --cl` | Clear all config (pre-uninstall) | Immediate |
58
- | `/pch --h` | Help | — |
59
-
60
- ### Slogan color
61
-
62
- Slogan color is independent of the logo color and persisted as `ccHeader.sloganColorCode`.
63
-
64
- ```bash
65
- /pch --s -c g # green slogan text
66
- /pch --s -c # toggle slogan color on/off
67
- ```
68
-
69
- The quote author name always matches the current slogan color.
70
-
71
- ### Quotes
72
-
73
- `/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**.
74
-
75
- Quotes are loaded from a `quotes.json` file. The package ships a default set of 70 quotes; you can override it by placing your own `quotes.json` in your project root (mirroring the array-of-objects shape below):
76
-
77
- ```json
78
- [
79
- { "quote": "You have power over your mind - not outside events. Realize this, and you will find strength.", "author": "Marcus Aurelius" }
80
- ]
81
- ```
82
-
83
- Quotes over 10 words are split as evenly as possible across up to 2 lines, preferring a break at punctuation (`. , : ; -`). The author name sits centered beneath, in the slogan color.
84
-
85
- ### Custom ASCII logo
86
-
87
- `/pch --logo` replaces the final animation frame with your own text/art (pipe-separated lines become rows). Lines may carry their own ANSI color.
88
-
89
- ```bash
90
- /pch --logo ████ | ▓▓▓▓ | ░░░░ # 3-line custom logo
91
- /pch --logo -d # restore built-in Pi logo
92
- ```
93
-
94
- ## Reset, disable, uninstall
95
-
96
- - `/pch --df` — reset all settings to defaults. Does not preserve current config.
97
- - `/pch --tg` — disable/re-enable. While disabled, all style commands are locked. Re-enabling takes effect next session.
98
- - To uninstall cleanly: `/pch --cl` first, then `pi uninstall npm:@tenchi4u/pi-cc-header`.
99
-
100
- ## Project additions
101
-
102
- This project includes these additions:
103
-
104
- | Feature | Description | Command |
105
- |---------|-------------|---------|
106
- | Custom ASCII logo | Substitute final animation frame with your own art/text | `/pch --logo` |
107
- | Random quote slogan | `"quote"` + centered author; auto-rotates each startup | `/pch --s -quote` |
108
- | Independent slogan color | Slogan (and its author) colored separately from the logo | `/pch --s -c <code>` |
109
- | `quotes.json` corpus | 67 default quotes, overridable per-project | — |
110
-
111
- Scope notes:
112
-
113
- - `readOnlyConfig` mode and the read-only write guards are inherited from upstream (not fork additions).
114
- - This project ships a smaller, English-only README and no built-in asset images (logo art is code-generated).
115
- - The core animation, palette, stripes, Minecraft gradient, and info-bar fields are unchanged from upstream.
1
+ # pi-cc-header
2
+
3
+ Claude Code–style startup header for [Pi](https://pi.dev). Animated Pi logo, 9-color palette, IBM stripes, Minecraft gradient, and a configurable info bar.
4
+
5
+ Maintained independently. Includes custom ASCII logos, random quote slogans, and an independent slogan color.
6
+
7
+ ## Install
8
+
9
+ ```bash
10
+ pi install npm:@tenchi4u/pi-cc-header
11
+ ```
12
+
13
+ Takes effect on next session or `/reload`.
14
+
15
+ If your Pi config is read-only (NixOS, declarative setup), set:
16
+
17
+ ```json
18
+ { "ccHeader": { "readOnlyConfig": true } }
19
+ ```
20
+
21
+ Visual changes still apply per-session but won't be persisted.
22
+
23
+ ## Features
24
+
25
+ - 14-frame Pi logo animation, speed 25/50/75/100 ms
26
+ - 9-color palette: Anthropic orange, Clawd red, and more
27
+ - IBM-style horizontal stripes
28
+ - Minecraft-style pixel theme with 4-level 24-bit gradient
29
+ - Info bar: version, model, thinking level, skills, prompts, extensions, cwd, AGENTS.md marker
30
+ - Customizable slogan
31
+ - **Custom ASCII logo** (replace the final animation frame)
32
+ - **Random quote slogan** (`"quote"` + centered author, auto-rotated each startup)
33
+ - **Independent slogan color** (separate from the logo/header color; quote authors use a matching complementary color)
34
+
35
+ ## Commands
36
+
37
+ All flags under `/pch`:
38
+
39
+ | Flag | Description | Effect |
40
+ |------|-------------|--------|
41
+ | `/pch --tg` | Toggle header enable/disable | Next session |
42
+ | `/pch --c [code]` | Logo/header color (`c/a/r/o/y/g/w/b/p`); no arg = show current | Immediate |
43
+ | `/pch --i` | Toggle IBM stripes | Immediate |
44
+ | `/pch --m` | Toggle Minecraft gradient | Immediate |
45
+ | `/pch --sp [ms]` | Speed (`25/50/75/100`); no arg = show current | Immediate |
46
+ | `/pch --v [all\|pi\|off]` | Version label color; no arg = cycle | Immediate |
47
+ | `/pch --ps` | Toggle pkg skills count | Immediate |
48
+ | `/pch --s [text]` | Set slogan to literal text | Immediate |
49
+ | `/pch --s` | Toggle slogan on/off | Immediate |
50
+ | `/pch --s -c [code]` | Slogan color (same codes as `--c`); no code = toggle on/off | Immediate |
51
+ | `/pch --s -d` | Delete slogan | Immediate |
52
+ | `/pch --s -quote` | Pick a random quote as slogan; enables startup auto-rotation | Immediate |
53
+ | `/pch --logo <l1\|l2\|...>` | Set custom ASCII logo lines (pipe-separated) | Immediate |
54
+ | `/pch --logo -d` | Restore built-in Pi logo | Immediate |
55
+ | `/pch --ml` | Toggle model/thinking line | Immediate |
56
+ | `/pch --df` | Reset to defaults | Immediate |
57
+ | `/pch --cl` | Clear all config (pre-uninstall) | Immediate |
58
+ | `/pch --h` | Help | — |
59
+
60
+ ### Slogan color
61
+
62
+ Slogan color is independent of the logo color and persisted as `ccHeader.sloganColorCode`.
63
+
64
+ ```bash
65
+ /pch --s -c g # green slogan text
66
+ /pch --s -c # toggle slogan color on/off
67
+ ```
68
+
69
+ The author name uses a complementary color chosen for the current slogan color; its `~` prefix remains muted gray.
70
+
71
+ ### Quotes
72
+
73
+ `/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**.
74
+
75
+ 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):
76
+
77
+ ```json
78
+ [
79
+ { "quote": "You have power over your mind - not outside events. Realize this, and you will find strength.", "author": "Marcus Aurelius" }
80
+ ]
81
+ ```
82
+
83
+ Quotes over 10 words are split as evenly as possible across up to 2 lines, preferring a break at punctuation (`. , : ; -`). The author name sits centered beneath, in the slogan color.
84
+
85
+ ### Custom ASCII logo
86
+
87
+ `/pch --logo` replaces the final animation frame with your own text/art (pipe-separated lines become rows). Lines may carry their own ANSI color.
88
+
89
+ ```bash
90
+ /pch --logo ████ | ▓▓▓▓ | ░░░░ # 3-line custom logo
91
+ /pch --logo -d # restore built-in Pi logo
92
+ ```
93
+
94
+ ## Reset, disable, uninstall
95
+
96
+ - `/pch --df` — reset all settings to defaults. Does not preserve current config.
97
+ - `/pch --tg` — disable/re-enable. While disabled, all style commands are locked. Re-enabling takes effect next session.
98
+ - To uninstall cleanly: `/pch --cl` first, then `pi uninstall npm:@tenchi4u/pi-cc-header`.
99
+
100
+ ## Project additions
101
+
102
+ This project includes these additions:
103
+
104
+ | Feature | Description | Command |
105
+ |---------|-------------|---------|
106
+ | Custom ASCII logo | Substitute final animation frame with your own art/text | `/pch --logo` |
107
+ | Random quote slogan | `"quote"` + centered author; auto-rotates each startup | `/pch --s -quote` |
108
+ | Independent slogan color | Slogan (and its author) colored separately from the logo | `/pch --s -c <code>` |
109
+ | `quotes.json` corpus | 71 default quotes, overridable per-project | — |
110
+
111
+ Scope notes:
112
+
113
+ - `readOnlyConfig` mode and the read-only write guards are inherited from upstream (not fork additions).
114
+ - This project ships a smaller, English-only README and no built-in asset images (logo art is code-generated).
115
+ - The core animation, palette, stripes, Minecraft gradient, and info-bar fields are unchanged from upstream.