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

package/README.md

@@ -10,6 +10,7 @@ A [`pi-coding-agent`](https://github.com/earendil-works/pi) extension that gives
 - **Header Box**: Optional welcome panel with a logo and "Welcome back!" heading, model name, current working directory, Git status, and a random tip
 - **Working Messages**: Randomized loading status messages during response generation, updated on a configurable timer
 - **Native Theme Support**: Uses pi `ThemeColor` tokens to automatically align with your active theme
+- **Command Palette**: `alt+p` opens a filterable list of built-in and registered slash commands
 
 ---
 
@@ -42,10 +43,7 @@ Configuration is loaded from `~/.pi/agent/pi-zen-frame.json`. All properties are
   // Fallback accent color for frame border and active segments
   "accentColor": "accent",
 
-  // Master mute: renders all segments in muted tones except agent-mode (default: false)
-  "zenMode": false,
-
-  // Editor-frame renderer by registered name (built-in: "blocky")
+  // Editor-frame renderer by registered name (built-in: "blocky", "minimalist")
   "editorFrame": "blocky",
 
   "header": {
@@ -90,27 +88,27 @@ Configuration is loaded from `~/.pi/agent/pi-zen-frame.json`. All properties are
 
 The editor frame shows status indicators in two rows below the editor:
 
-| Location           | Segment        | Description                                                           |
-| ------------------ | -------------- | --------------------------------------------------------------------- |
-| Editor band (left) | **agent mode** | Active agent indicator pill from `pi-agent-manager`                   |
-|                    | **model**      | Active model name and provider                                        |
-|                    | **reasoning**  | Current reasoning effort level, tinted with pi thinking tokens        |
+| Location           | Segment        | Description                                                                                                                                         |
+| ------------------ | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Editor band (left) | **agent mode** | Active agent indicator pill from `pi-agent-manager`                                                                                                 |
+|                    | **model**      | Active model name and provider                                                                                                                      |
+|                    | **reasoning**  | Current reasoning effort level, tinted with pi thinking tokens                                                                                      |
 |                    | **spinner**    | Active phase indicator (`thinking`, `outputting`, `toolcall`, `exec`); replaces the row while streaming when `showSpinner` is enabled (default off) |
-| Footer (left)      | **cwd**        | Shortened path, active Git branch, and uncommitted file counts        |
-| Footer (right)     | **ctx**        | Context usage percentage and token counts with color alerts           |
+| Footer (left)      | **cwd**        | Shortened path, active Git branch, and uncommitted file counts                                                                                      |
+| Footer (right)     | **ctx**        | Context usage percentage and token counts with color alerts                                                                                         |
 
 ---
 
 ## Commands & Keybindings
 
-- **Toggle Command**: `/zen_mode` — Toggles Zen mode on and off.
-- **Default Keybinding**: `ctrl+shift+z`
+- **Command Palette**: `alt+p` — filter and insert built-in or registered slash commands.
+- **Palette Keys**: `↑`/`↓` navigate, `Enter` inserts the command, `Esc` closes.
 
 To rebind or disable the hotkey, update `~/.pi/agent/keybindings.json`:
 
 ```jsonc
 {
-  "piZenFrame.zenMode": "ctrl+shift+z", // Set to [] to disable the shortcut
+  "piZenFrame.palette": "alt+p", // Set to [] to disable the shortcut
 }
 ```
 
@@ -125,7 +123,7 @@ extensions/
 ├── index.ts            # Extension entry point: config initialization and events
 ├── config/             # Types, defaults, and settings normalization
 ├── components/         # Status segments, header, and frame layout helpers
-├── editor/             # BlockyEditor editor-frame renderer
+├── editor/             # Editor-frame renderers (blocky / minimalist) + palette
 ├── renderers/          # Renderer registry + swap-in API (blocky / basic)
 └── utils/              # Helpers for Git status, paths, agent modes, and token usage
 

package/extensions/components/agent-mode.ts

@@ -3,7 +3,7 @@ import { capitalize } from "../utils";
 import type { SegmentDef } from "./types";
 
 /** Pseudo-footer (left): the current Agent Mode from pi-agent-manager
- *  (when installed). Rendered as a pill using the agent's own color/icon. */
+ *  (when installed). Rendered as a pill using the agent's own color/icon */
 export const agentModeSegment: SegmentDef = {
   id: "agent-mode",
   slot: "topLeft",
@@ -13,7 +13,6 @@ export const agentModeSegment: SegmentDef = {
     const m = d.agentMode;
     if (!m) return "";
 
-    // Agent's own color wins; accent fills in. Zen never mutes the agent.
     const color = m.color ?? d.accentColor;
     const label = ` ${capitalize(m.name)} `;
 

package/extensions/components/cwd.ts

@@ -15,11 +15,11 @@ export const cwdSegment: SegmentDef = {
       let git = ` ${icons.gitBranch} ${d.gitBranch}`;
       text +=
         theme.fg("dim", " ·") +
-        theme.fg(d.zenMode ? "muted" : d.accentColor, git);
+        theme.fg(d.accentColor, git);
 
       if (d.gitDirty > 0) {
         text += theme.fg(
-          d.zenMode ? "muted" : "error",
+          "error",
           ` ${icons.gitDirty} ${d.gitDirty}`,
         );
       }

package/extensions/components/header.ts

@@ -6,10 +6,7 @@ import type {
   ThemeColor,
 } from "@earendil-works/pi-coding-agent";
 
-import {
-  DEFAULT_ICONS,
-  HEADER_TIPS,
-} from "../config/constants";
+import { DEFAULT_ICONS, HEADER_TIPS } from "../config/constants";
 import type { Settings } from "../config/types";
 import { fitFrameRow } from "./frame";
 import { getShortCwd } from "../utils";
@@ -19,12 +16,7 @@ const MIN_BOX_WIDTH = 20;
 const LEFT_COL_RATIO = 0.4; // logo column width / total width
 
 /** BasicHeader preset styling — self-contained, not user-configurable. */
-const LOGO_LINES = [
-  "█████████  ",
-  "███   ███  ",
-  "██████     ",
-  "███     ███",
-];
+const LOGO_LINES = ["█████████  ", "███   ███  ", "██████     ", "███     ███"];
 const LOGO_COLOR: ThemeColor = "text";
 const HEADING = "Welcome back!";
 const SUBHEADING =
@@ -160,17 +152,15 @@ export function createHeader(
         "",
         "",
 
-        ...wrapLines(
-          [HEADING],
-          leftW - 2,
-        ).map((line) => theme.bold(theme.fg("muted", line))),
+        ...wrapLines([HEADING], leftW - 2).map((line) =>
+          theme.bold(theme.fg("muted", line)),
+        ),
 
         "",
 
-        ...wrapLines(
-          [SUBHEADING],
-          leftW - 2,
-        ).map((line) => theme.italic(theme.fg("muted", line))),
+        ...wrapLines([SUBHEADING], leftW - 2).map((line) =>
+          theme.italic(theme.fg("muted", line)),
+        ),
       ];
 
       // Too narrow for a box → fall back to a plain centered logo.

package/extensions/components/notify.ts

@@ -0,0 +1,13 @@
+import type { SegmentDef } from "./types";
+
+/** Box bottom (left): pi-notify bell, right before the model segment.
+ *  Accent when notifications are on, muted bell-off otherwise */
+export const notifySegment: SegmentDef = {
+  id: "notify",
+  slot: "topLeft",
+  render: (d, { icons, theme }) => {
+    const color = d.notifyEnabled ? d.accentColor : "muted";
+
+    return theme.fg(color, ` ${d.notifyEnabled ? icons.bell : icons.bellOff} `);
+  },
+};

package/extensions/components/reasoning.ts

@@ -16,7 +16,7 @@ export const reasoningSegment: SegmentDef = {
       "thinkingText") as ThemeColor;
 
     return theme.fg(
-      d.zenMode ? "muted" : token,
+      token,
       ` ${icons.thinking} ${d.thinkingLevel} `,
     );
   },

package/extensions/components/registry.ts

@@ -5,6 +5,7 @@
  * The frame calls `segmentsFor(slot, ...)` and handles all width/joining.
  */
 import { modelSegment } from "./model";
+import { notifySegment } from "./notify";
 import { reasoningSegment } from "./reasoning";
 import { spinnerSegment } from "./spinner";
 import { tokenCountSegment } from "./token-count";
@@ -14,6 +15,7 @@ import type { FrameData, SegmentContext, SegmentDef, Slot } from "./types";
 
 export const segments: SegmentDef[] = [
   agentModeSegment,
+  notifySegment,
   modelSegment,
   reasoningSegment,
   spinnerSegment,

package/extensions/components/spinner.ts

@@ -12,9 +12,9 @@ export const spinnerSegment: SegmentDef = {
   render: (d, { theme }) => {
     let phase = d.spinnerPhase ?? "thinking";
 
-    // No frame.colors key for the spinner; zen mutes it, else accent.
+    // No frame.colors key for the spinner; accent only.
     const spinner = theme.fg(
-      d.zenMode ? "muted" : d.accentColor,
+      d.accentColor,
       ` ${d.spinnerFrame} `,
     );
     if (phase === "idle") return spinner;

package/extensions/components/token-count.ts

@@ -44,13 +44,12 @@ export const tokenCountSegment: SegmentDef = {
       }
     }
 
-    const color2 = d.zenMode ? "muted" : color;
     const used = tokens === null ? "?" : formatTokens(tokens);
 
     return (
-      theme.fg(color2, ` ${icons.context} ctx ${pct} `) +
+      theme.fg(color, ` ${icons.context} ctx ${pct} `) +
       theme.fg("dim", "·") +
-      theme.fg(color2, ` ${used}/${formatWindow(window)} `) +
+      theme.fg(color, ` ${used}/${formatWindow(window)} `) +
       theme.fg("dim", "·") +
       theme.fg(
         "dim",

package/extensions/components/types.ts

@@ -49,13 +49,13 @@ export interface FrameData {
   spinnerPhase: SpinnerPhase | null;
   thinkingLevel: string | undefined;
 
-  /** Master mute: when true, every segment except agentMode renders muted. */
-  zenMode: boolean;
-
   /** To render the agent mode (from @leo-alvarenga/pi-agent-manager) segment, if any */
   agentMode: AgentMode;
 
   context: TokenUsage | null;
+
+  /** pi-notify toggle state (true = notifications enabled). */
+  notifyEnabled: boolean;
 }
 
 /** Data + rendering helpers handed to every segment. */
@@ -85,7 +85,6 @@ export interface SegmentDef {
 export interface ExternalData {
   cwd: string;
   gitDirty: number;
-  zenMode: boolean;
   agentMode: AgentMode;
   theme: Theme | undefined;
   gitBranch: string | undefined;
@@ -94,4 +93,5 @@ export interface ExternalData {
   modelProvider: string | undefined;
   thinkingLevel: string | undefined;
   spinnerPhase: SpinnerPhase | null;
+  notifyEnabled: boolean;
 }

package/extensions/config/constants/contracts.ts

@@ -1,12 +1,10 @@
-/** External contract IDs: the zen-mode keybinding and the optional
- *  pi-agent-manager integration (no hard dependency).
- */
-/** pi-agent-manager integration (optional — no hard dependency). */
+/** pi-agent-manager integration (optional: no hard dependency) */
 export const PI_AGENT_MANAGER_AGENT_EVENT = "pi-agent-manager:agent-changed";
 export const PI_AGENT_MANAGER_AGENT_DATA_KEY = "pi-agent-manager-agent";
 
-/** Keybinding id users bind in keybindings.json to toggle zen mode. */
-export const ZEN_MODE_SHORTCUT_ID = "piZenFrame.zenMode";
-/** Default key when the user hasn't bound one (override or disable via
- *  keybindings.json; `[]` disables the shortcut, `/zen_mode` still works). */
-export const ZEN_MODE_DEFAULT_KEY = "ctrl+shift+z";
+/** pi-notify integration (optional: no hard dependency) */
+export const PI_NOTIFY_TOGGLE_EVENT = "pi-notify:toggle-changed";
+
+/** Keybinding id users bind in keybindings.json to open the command palett. */
+export const PALETTE_SHORTCUT_ID = "piZenFrame.palette";
+export const PALETTE_DEFAULT_KEY = "alt+p";

package/extensions/config/constants/defaults.ts

@@ -1,7 +1,7 @@
 import type { Settings } from "../types";
 import { WORKING_MESSAGES } from "./messages";
+
 export const DEFAULT_SETTINGS: Settings = {
-  zenMode: false,
   accentColor: "accent",
   editorFrame: "blocky",
 

package/extensions/config/constants/index.ts

@@ -1,10 +1,5 @@
-/**
- * Constants, grouped by concern and re-exported from a single barrel.
- * Import everything with `import { ... } from "../config/constants"` —
- * resolution keeps working now that this is a directory.
- */
 export * from "./file";
 export * from "./contracts";
 export * from "./visuals";
 export * from "./messages";
-export * from "./defaults";
+export * from "./defaults";

package/extensions/config/constants/visuals.ts

@@ -1,6 +1,7 @@
 import type { ThemeColor } from "@earendil-works/pi-coding-agent";
 import type { FrameIcons, SpinnerPhase } from "../types";
-/** Spinner animation frames per phase (pi-editor-shell style). */
+
+/** Spinner animation frames per phase (pi-editor-shell style) */
 export const SPINNER_FRAMES: Record<SpinnerPhase, string[]> = {
   idle: ["⠃", "⠞", "⡵", "⠿", "⢹", "⠄"],
   outputting: ["⠋", "⠙", "⠸", "⠴", "⠦", "⠇", "⠏"],
@@ -11,7 +12,7 @@ export const SPINNER_FRAMES: Record<SpinnerPhase, string[]> = {
   // Sample ["░", "▒", "▓", "█", "▓", "▒"],
 };
 
-/** Nerd Font glyphs used by the blocky editor preset. */
+/** Nerd Font glyphs used by the blocky editor preset */
 export const DEFAULT_ICONS: FrameIcons = {
   model: "󰣖",
   folder: " ",
@@ -21,17 +22,19 @@ export const DEFAULT_ICONS: FrameIcons = {
   gitDirty: "",
   thinking: "󰌶",
   gitBranch: "",
+  bell: "󰂚",
+  bellOff: "󰂛",
 };
 
-/** Thinking level → theme token, mirroring pi's own border-color mapping. */
+/** Thinking level → theme token, mirroring pi's own border-color mapping */
 export const THINKING_TOKEN: Record<string, string> = {
-  off: "thinkingOff",
-  minimal: "thinkingMinimal",
   low: "thinkingLow",
-  medium: "thinkingMedium",
+  max: "thinkingMax",
+  off: "thinkingOff",
   high: "thinkingHigh",
   xhigh: "thinkingXhigh",
-  max: "thinkingMax",
+  medium: "thinkingMedium",
+  minimal: "thinkingMinimal",
 };
 
 export const THEME_COLORS: Record<ThemeColor, true> = {

package/extensions/config/settings.ts

@@ -19,7 +19,7 @@ function loadSettingsFile(): Promise<string> {
   return readFile(getResolvedSettingsFilePath(), "utf8");
 }
 
-/** Validate a raw (possibly malformed) config against the schema shapes. */
+/** Validate a raw (possibly malformed) config against the schema shapes */
 function normalize(raw: unknown): Settings {
   if (!raw || typeof raw !== "object") return DEFAULT_SETTINGS;
 
@@ -37,7 +37,6 @@ function normalize(raw: unknown): Settings {
   const out: Settings = {
     ...DEFAULT_SETTINGS,
     frame: { ...DEFAULT_SETTINGS.frame },
-    zenMode: bool(r.zenMode, d.zenMode ?? true),
     editorFrame:
       typeof r.editorFrame === "string" ? r.editorFrame : d.editorFrame,
   };
@@ -95,6 +94,7 @@ function normalize(raw: unknown): Settings {
 export async function loadSettings(): Promise<Settings> {
   try {
     const raw = JSON.parse(await loadSettingsFile()) as unknown;
+
     return normalize(raw);
   } catch {
     return DEFAULT_SETTINGS;

package/extensions/config/types.ts

@@ -1,6 +1,6 @@
 import type { ThemeColor } from "@earendil-works/pi-coding-agent";
 
-/** Streaming phase used to drive the status-animation spinner. */
+/** Streaming phase used to drive the status-animation spinner */
 export type SpinnerPhase =
   "thinking" | "outputting" | "toolcall" | "exec" | "idle";
 
@@ -9,7 +9,7 @@ export interface BannerTip {
   text: string;
 }
 
-/** Nerd-font / glyph icons shown in the band and status rows. Overridable. */
+/** Nerd-font / glyph icons shown in the band and status rows. Overridable */
 export interface FrameIcons {
   folder: string;
   model: string;
@@ -19,12 +19,14 @@ export interface FrameIcons {
   thinking: string;
   gitDirty: string;
   gitBranch: string;
+  bell: string;
+  bellOff: string;
 }
 
 /**
- * ``frame`` — the editor frame preset. Styling and layout (prefix, colors,
+ * ``frame``: the editor frame preset. Styling and layout (prefix, colors,
  * margins, paddings) are owned by the renderer; only these behavioral
- * toggles are configurable.
+ * toggles are configurable
  */
 export interface FrameSettings {
   enable?: boolean;
@@ -42,7 +44,7 @@ export interface FrameSettings {
   showSpinner?: boolean;
 }
 
-/** `header` — the top-line header, which can show a logo or other text */
+/** `header`: the top-line header, which can show a logo or other text */
 export interface HeaderSettings {
   enable: boolean;
 
@@ -50,15 +52,15 @@ export interface HeaderSettings {
   type?: string;
 }
 
-/** `workingMessage` — rotating messages in pi's built-in working loader. */
+/** `workingMessage`: rotating messages in pi's built-in working loader */
 export interface WorkingMessageSettings {
-  /** Toggle the rotating messages. Default true. */
+  /** Toggle the rotating messages. Default true */
   enable?: boolean;
 
-  /** How often (ms) the message is replaced. Default 3000. */
+  /** How often (ms) the message is replaced. Default 3000 */
   intervalMs?: number;
 
-  /** Custom message pool; replaces the default 30. */
+  /** Custom message pool; replaces the default 30 */
   messages?: string[];
 }
 
@@ -67,14 +69,9 @@ export interface Settings {
   header?: HeaderSettings;
   workingMessage?: WorkingMessageSettings;
 
-  /** Editor-frame renderer by registered name. Default "blocky". */
+  /** Editor-frame renderer by registered name. Default "blocky" */
   editorFrame?: string;
 
-  /** Master mute: every segment except agent-mode renders muted.
-   *  Default true. Toggle at runtime with `/zen_mode` or the `piZenFrame.zenMode`
-   *  keybinding (default `ctrl+shift+z`). */
-  zenMode?: boolean;
-
   /** Accent color for segment highlights; Defaults to 'accent' */
   accentColor?: ThemeColor;
 }