@leo-alvarenga/pi-zen-frame 0.16.0 → 0.16.1

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 (2) hide show
  1. package/README.md +19 -17
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -6,8 +6,8 @@ A [`pi-coding-agent`](https://github.com/earendil-works/pi) extension that gives
6
6
 
7
7
  ## Features
8
8
 
9
- - **Clean Frame**: Clean editor frame with segments placed above and below it to easily see relevant info
10
- - **Header Box**: Optional Claude-style welcome panel displaying a logo, model/provider info, current working directory, and Git status
9
+ - **Clean Frame**: Clean editor frame with status segments rendered below the editor
10
+ - **Header Box**: Optional welcome panel with a logo and "Welcome back!" heading, model name, current working directory, Git status, and a random tip
11
11
  - **Working Messages**: Randomized loading status messages during response generation, updated on a configurable timer
12
12
  - **Native Theme Support**: Uses pi `ThemeColor` tokens to automatically align with your active theme
13
13
 
@@ -18,7 +18,7 @@ A [`pi-coding-agent`](https://github.com/earendil-works/pi) extension that gives
18
18
  Run the following command:
19
19
 
20
20
  ```bash
21
- pi install @leo-alvarenga/pi-zen-frame
21
+ pi install npm:@leo-alvarenga/pi-zen-frame
22
22
  ```
23
23
 
24
24
  Or add `pi-zen-frame` to your pi packages list in `~/.pi/agent/settings.json`:
@@ -42,14 +42,15 @@ Configuration is loaded from `~/.pi/agent/pi-zen-frame.json`. All properties are
42
42
  // Fallback accent color for frame border and active segments
43
43
  "accentColor": "accent",
44
44
 
45
- // Master mute: renders all segments in muted tones except agent-mode
46
- "zenMode": true,
45
+ // Master mute: renders all segments in muted tones except agent-mode (default: false)
46
+ "zenMode": false,
47
47
 
48
48
  // Editor-frame renderer by registered name (built-in: "blocky")
49
49
  "editorFrame": "blocky",
50
50
 
51
51
  "header": {
52
- "enable": true,
52
+ // Welcome panel is opt-in (default: false)
53
+ "enable": false,
53
54
  // Header renderer by registered name (built-in: "basic")
54
55
  "type": "basic",
55
56
  },
@@ -73,6 +74,7 @@ Configuration is loaded from `~/.pi/agent/pi-zen-frame.json`. All properties are
73
74
  "workingMessage": {
74
75
  "enable": true,
75
76
  "intervalMs": 3000,
77
+ // Omit to use the built-in message pool
76
78
  "messages": [
77
79
  "Exploring the seas",
78
80
  "Tinkering with strange objects",
@@ -86,16 +88,16 @@ Configuration is loaded from `~/.pi/agent/pi-zen-frame.json`. All properties are
86
88
 
87
89
  ## Structure & Status Segments
88
90
 
89
- The editor window features status indicators embedded along the frame borders:
91
+ The editor frame shows status indicators in two rows below the editor:
90
92
 
91
- | Location | Segment | Description |
92
- | ---------------- | -------------- | --------------------------------------------------------------------- |
93
- | **Top Left** | **model** | Active model name and provider |
94
- | | **reasoning** | Current reasoning effort level, tinted with pi thinking tokens |
95
- | | **spinner** | Active phase indicator (`thinking`, `outputting`, `toolcall`, `exec`) |
96
- | **Top Right** | **ctx** | Context usage percentage and token counts with color alerts |
97
- | **Bottom Left** | **agent mode** | Active agent indicator pill from `pi-agent-manager` |
98
- | **Bottom Right** | **cwd** | Shortened path, active Git branch, and uncommitted file counts |
93
+ | Location | Segment | Description |
94
+ | ------------------ | -------------- | --------------------------------------------------------------------- |
95
+ | Editor band (left) | **agent mode** | Active agent indicator pill from `pi-agent-manager` |
96
+ | | **model** | Active model name and provider |
97
+ | | **reasoning** | Current reasoning effort level, tinted with pi thinking tokens |
98
+ | | **spinner** | Active phase indicator (`thinking`, `outputting`, `toolcall`, `exec`); replaces the row while streaming when `showSpinner` is enabled (default off) |
99
+ | Footer (left) | **cwd** | Shortened path, active Git branch, and uncommitted file counts |
100
+ | Footer (right) | **ctx** | Context usage percentage and token counts with color alerts |
99
101
 
100
102
  ---
101
103
 
@@ -122,9 +124,9 @@ Run `/reload` after modifying your keybindings.
122
124
  extensions/
123
125
  ├── index.ts # Extension entry point: config initialization and events
124
126
  ├── config/ # Types, defaults, and settings normalization
125
- ├── components/ # Header (BasicHeader), frame border, and status segment modules
127
+ ├── components/ # Status segments, header, and frame layout helpers
126
128
  ├── editor/ # BlockyEditor editor-frame renderer
127
129
  ├── renderers/ # Renderer registry + swap-in API (blocky / basic)
128
- └── utils/ # Helpers for Git status, paths, and agent modes
130
+ └── utils/ # Helpers for Git status, paths, agent modes, and token usage
129
131
 
130
132
  ```
package/package.json CHANGED
@@ -2,7 +2,7 @@
2
2
  "name": "@leo-alvarenga/pi-zen-frame",
3
3
  "description": "A pi-coding-agent extension that gives the TUI editor a simple yet polished look and feel",
4
4
  "author": "Leonardo A. Alvarenga",
5
- "version": "0.16.0",
5
+ "version": "0.16.1",
6
6
  "license": "MIT",
7
7
  "repository": "github.com/leo-alvarenga/pi-mono",
8
8
  "publishConfig": {