pi-zentui 0.11.0 → 0.12.0

package/README.md

@@ -21,7 +21,7 @@ Zentui brings two popular aesthetics to Pi:
 - `on  branch` — git branch with icon
 - `[!?↑]` — git status indicators (modified, untracked, ahead/behind, stashed, etc.)
 - `via  v5.5.0` — runtime detection with version and Starship-style Nerd Font runtime/language modules
-- Optional segments (off by default): `user@host`, current time, OS icon, session duration, and the **project package version** (e.g. `package.json` → `0.6.0`) — distinct from the runtime segment, which shows the installed toolchain
+- Optional segments (off by default): session name, `user@host`, current time, OS icon, session duration, and the **project package version** (e.g. `package.json` → `0.6.0`) — distinct from the runtime segment, which shows the installed toolchain
 - Right side shows context usage, token counts, and cost
 - Built-in footer segments can be shown or hidden individually from `/zentui`
 - Fully custom Starship-style layout via a `footerFormat` template string — see [Footer Format Template](#footer-format-template)
@@ -194,6 +194,7 @@ Default config values — copy this and change any value you want:
 	},
 	"colors": {
 		"cwd": "bold cyan",
+		"sessionName": "bold green",
 		"gitBranch": "bold purple",
 		"gitStatus": "bold red",
 		"contextNormal": "bright-black",
@@ -236,6 +237,7 @@ Default config values — copy this and change any value you want:
 	},
 	"footerSegments": {
 		"cwd": true,
+		"sessionName": true,
 		"gitBranch": true,
 		"gitStatus": true,
 		"gitCounts": false,
@@ -283,7 +285,7 @@ Default config values — copy this and change any value you want:
 - `icons`: every shown icon key is configurable; omit any key to use the Zentui default. `icons.mode` is `auto` | `nerd` | `ascii` (default `auto`, same glyphs as nerd). ASCII mode swaps in plain fallbacks for statusline icons and runtime symbols — useful without a Nerd Font. Custom per-icon strings always win over mode defaults. Custom `icons.os` always wins; when left at the mode default, Zentui maps the OS icon by platform. `rail` sets the vertical glyph drawn as the left rail of the active editor frame and previous user messages when `copyFriendly` is disabled (default `│`; any single Unicode vertical or block glyph). `editorPrompt` controls an optional copy-friendly editor prompt glyph; the default is `""` so copy-friendly mode stays rail-free.
 - `colorSources`: `theme` maps styles through Pi theme tokens; `terminal` emits terminal colors. `/zentui` switches these sources; manual JSON controls specific style values.
 - `features`: `editor` enables Zentui's custom editor, selector borders, and previous-message chrome. `statusLine` enables Zentui's custom footer/status line. `copyFriendly` hides editor and previous-message rail glyphs so native terminal selection copies less chrome. All three can be changed from `/zentui` or direct slash-command arguments.
-- `footerSegments`: show or hide individual built-in footer segments (`cwd`, `gitBranch`, `gitStatus`, `gitCounts`, `gitCommit`, `gitMetrics`, `runtime`, `packageVersion`, `sessionDuration`, `username`, `time`, `os`, `context`, `tokens`, `cost`). Toggle them from the `Built-in segments` tab in `/zentui`.
+- `footerSegments`: show or hide individual built-in footer segments (`cwd`, `sessionName`, `gitBranch`, `gitStatus`, `gitCounts`, `gitCommit`, `gitMetrics`, `runtime`, `packageVersion`, `sessionDuration`, `username`, `time`, `os`, `context`, `tokens`, `cost`). Toggle them from the `Built-in segments` tab in `/zentui`.
 - `footerFormat`: optional Starship-style template string that fully controls the footer layout. When set, it overrides `footerSegments`. See [Footer Format Template](#footer-format-template) below. The `/zentui` **Layout** tab configures context style, separator, path display mode/depth, branch length, and icon mode; set or clear custom formats with `/zentui format`.
 - `gitCommit`: Starship [`git_commit`](https://starship.rs/config/#git-commit)-style options for the `gitCommit` footer segment. `hashLength` (default `7`, clamped to `4`–`40`) controls the short-hash display length. `onlyDetached` (default `true`) shows the hash mainly on detached HEAD. `showTag` (default `true`) appends an exact-match tag (`git describe --tags --exact-match HEAD`). The tag probe piggybacks on the existing git refresh — it only runs when both the segment and `showTag` are on, and misses/failures degrade silently.
 - `gitMetrics`: Starship [`git_metrics`](https://starship.rs/config/#git-metrics)-style options for the `gitMetrics` footer segment. Uses `git diff HEAD --numstat` (staged + unstaged combined — the Starship “total dirty” view) to show aggregate `+added −deleted` line counts. `onlyNonzero` (default `true`) omits each zero component independently and hides the segment entirely at `0/0`. `ignoreSubmodules` (default `false`) adds `--ignore-submodules=all`. The numstat diff piggybacks on the existing git refresh and uses a hard 2s timeout; a metrics-only failure degrades silently without discarding fresh branch/status data. On very large monorepos the diff may lag or be omitted on timeout.
@@ -304,7 +306,7 @@ A second `$fill` creates a **centered middle zone** — content between the two
 
 ```json
 {
-	"footerFormat": "$os $username $cwd( on $git_branch)( $git_status)( via $runtime)$fill($context)($sep$tokens)($sep$cost)($sep$time)"
+	"footerFormat": "$os $username $cwd($sep$session_name)( on $git_branch)( $git_status)( via $runtime)$fill($context)($sep$tokens)($sep$cost)($sep$time)"
 }
 ```
 
@@ -321,6 +323,7 @@ Center the branch between directory and cost:
 | Token               | Aliases      | Renders                                                             |
 | ------------------- | ------------ | ------------------------------------------------------------------- |
 | `$cwd`              | `$directory` | current directory                                                   |
+| `$session_name`     |              | current Pi session name                                             |
 | `$git_branch`       | `$branch`    | git branch with icon                                                |
 | `$git_status`       | `$status`    | `[!?↑]` status block                                                |
 | `$git_state`        | `$state`     | `REBASING` / `MERGING` / … (optional `n/m`)                         |
@@ -354,6 +357,7 @@ Center the branch between directory and cost:
 - Literal text (`on branch`, `using`, `\|`, spaces) is rendered verbatim — you control all spacing.
 - Each variable renders its core value only (no `on`/`via` prefixes); add those words as literal text.
 - Conditional groups: wrap optional pieces in parentheses, e.g. `$cwd( on $git_branch)($git_status)$fill($context)`. If every `$var` inside a group is empty, the whole group (including its literals) is dropped.
+- `$session_name` is available whenever `footerFormat` is set, independently of `footerSegments.sessionName`; use a conditional group such as `($sep$session_name)` so unnamed sessions leave no separator.
 - Unknown `$variables` render empty.
 - Set or clear at runtime: `/zentui format "<template>"` and `/zentui format clear`.
 
@@ -409,7 +413,7 @@ Mouse wheel scrolling is enabled by default when the fixed editor is on. Disable
 
 ## Requirements
 
-- [Pi](https://pi.dev) coding agent 0.80 or newer
+- [Pi](https://pi.dev) coding agent 0.80.3 or newer
 - A [Nerd Font](https://www.nerdfonts.com/) for icons (or set `icons.mode` to `"ascii"`)
 
 ## Development

package/extensions/zentui/config.ts

@@ -66,6 +66,7 @@ export type UiFeaturesConfig = {
 
 export type FooterSegmentsConfig = {
 	cwd: boolean;
+	sessionName: boolean;
 	gitBranch: boolean;
 	gitStatus: boolean;
 	gitCounts: boolean;
@@ -132,6 +133,7 @@ export type PolishedTuiConfig = {
 	icons: ResolvedIcons;
 	colors: {
 		cwd: ColorSpec;
+		sessionName: ColorSpec;
 		gitBranch: ColorSpec;
 		gitStatus: ColorSpec;
 		contextNormal: ColorSpec;
@@ -177,6 +179,7 @@ export type PolishedTuiConfig = {
  */
 export const FOOTER_FORMAT_VARIABLES = [
 	"cwd",
+	"session_name",
 	"git_branch",
 	"git_status",
 	"git_state",
@@ -229,6 +232,7 @@ export const defaultConfig: PolishedTuiConfig = {
 	},
 	colors: {
 		cwd: "bold cyan",
+		sessionName: "bold green",
 		gitBranch: "bold purple",
 		gitStatus: "bold red",
 		contextNormal: "bright-black",
@@ -260,6 +264,7 @@ export const defaultConfig: PolishedTuiConfig = {
 	},
 	footerSegments: {
 		cwd: true,
+		sessionName: true,
 		gitBranch: true,
 		gitStatus: true,
 		gitCounts: false,
@@ -431,6 +436,7 @@ function normalizeIconOverrides(record: Record<string, unknown>): Partial<IconGl
 function normalizeColors(record: Record<string, unknown>): Partial<PolishedTuiConfig["colors"]> {
 	return definedColors({
 		cwd: colorValue(record, "cwd") ?? colorValue(record, "cwdText"),
+		sessionName: colorValue(record, "sessionName"),
 		gitBranch: colorValue(record, "gitBranch") ?? colorValue(record, "git"),
 		gitStatus: colorValue(record, "gitStatus"),
 		contextNormal: colorValue(record, "contextNormal"),
@@ -482,6 +488,7 @@ function normalizeUiFeatures(record: Record<string, unknown>): UiFeaturesConfig
 function normalizeFooterSegments(record: Record<string, unknown>): FooterSegmentsConfig {
 	return {
 		cwd: footerSegmentValue(record, "cwd"),
+		sessionName: footerSegmentValue(record, "sessionName"),
 		gitBranch: footerSegmentValue(record, "gitBranch"),
 		gitStatus: footerSegmentValue(record, "gitStatus"),
 		gitCounts: footerSegmentValue(record, "gitCounts"),
@@ -593,6 +600,7 @@ function isUiFeatureKey(value: string): value is keyof UiFeaturesConfig {
 function isFooterSegmentKey(value: string): value is keyof FooterSegmentsConfig {
 	return (
 		value === "cwd" ||
+		value === "sessionName" ||
 		value === "gitBranch" ||
 		value === "gitStatus" ||
 		value === "gitCounts" ||

package/extensions/zentui/footer.ts

@@ -2,7 +2,11 @@ import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
 import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 import type { PolishedTuiConfig, SeparatorStyle } from "./config";
 import { FOOTER_FORMAT_ALIASES } from "./config";
-import { collectExtensionStatusSegments, type ExtensionStatusSegment } from "./extension-status";
+import {
+	collectExtensionStatusSegments,
+	type ExtensionStatusSegment,
+	sanitizeExtensionStatusText,
+} from "./extension-status";
 import { parseFooterFormat, renderFormatSplit, stripOrphanSeparators } from "./footer-format";
 import {
 	buildContextDisplayLabel,
@@ -195,6 +199,16 @@ export function installFooter(
 						depth: config.pathDisplay.depth,
 					}),
 				);
+				const needsSessionName = config.footerFormat
+					? /(?:\$session_name\b|\$\{session_name\})/.test(config.footerFormat)
+					: config.footerSegments.sessionName;
+				const sessionName = needsSessionName
+					? sanitizeExtensionStatusText(ctx.sessionManager.getSessionName() ?? "")
+					: "";
+				const sessionNameLabel = sessionName
+					? renderStyleForSource(theme, colorSource, config.colors.sessionName, sessionName)
+					: "";
+				const builtInSessionNameLabel = sessionNameLabel ? `in ${sessionNameLabel}` : "";
 				const branch = state.branch;
 				const branchText = branch
 					? formatGitBranchText(branch, config.gitBranch.maxLength)
@@ -263,6 +277,8 @@ export function installFooter(
 					switch (canonical) {
 						case "cwd":
 							return cwdLabel;
+						case "session_name":
+							return sessionNameLabel;
 						case "git_branch":
 							return branchText
 								? gitIcon
@@ -491,6 +507,7 @@ export function installFooter(
 					osSegment,
 					usernameSegment,
 					config.footerSegments.cwd ? cwdLabel : "",
+					config.footerSegments.sessionName ? builtInSessionNameLabel : "",
 					branchLabel,
 					gitCommitLabel,
 					gitMetricsLabel,

package/extensions/zentui/index.ts

@@ -536,6 +536,7 @@ export default function (pi: ExtensionAPI) {
 		syncInteractiveState(event, ctx);
 	});
 	pi.on("thinking_level_select", syncInteractiveState);
+	pi.on("session_info_changed", syncInteractiveState);
 	pi.on("message_update", (event) => {
 		liveContext.update(event.message);
 	});

package/extensions/zentui/settings-command.ts

@@ -124,6 +124,7 @@ const featureSettingDescriptions: Record<FeatureSettingId, string> = {
 
 const footerSegmentSettingLabels: Record<FooterSegmentSettingId, string> = {
 	cwd: "Current directory",
+	sessionName: "Session name",
 	gitBranch: "Git branch",
 	gitStatus: "Git status",
 	gitCounts: "Git counts",
@@ -142,6 +143,7 @@ const footerSegmentSettingLabels: Record<FooterSegmentSettingId, string> = {
 
 const footerSegmentSettingDescriptions: Record<FooterSegmentSettingId, string> = {
 	cwd: "Show or hide the current working directory segment on the left.",
+	sessionName: "Show or hide the current Pi session name on the left, after the current directory.",
 	gitBranch: "Show or hide the git branch name on the left.",
 	gitStatus: "Show or hide git status icons and ahead/behind markers.",
 	gitCounts:
@@ -207,6 +209,7 @@ function isFeatureSettingId(value: string): value is FeatureSettingId {
 function isFooterSegmentSettingId(value: string): value is FooterSegmentSettingId {
 	return (
 		value === "cwd" ||
+		value === "sessionName" ||
 		value === "gitBranch" ||
 		value === "gitStatus" ||
 		value === "gitCounts" ||

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-zentui",
-	"version": "0.11.0",
+	"version": "0.12.0",
 	"description": "A Starship-inspired statusline and Opencode-style TUI for Pi.",
 	"type": "module",
 	"license": "MIT",
@@ -35,9 +35,9 @@
 		"prepublishOnly": "npm run verify && npm run pack:check"
 	},
 	"peerDependencies": {
-		"@earendil-works/pi-ai": ">=0.80",
-		"@earendil-works/pi-coding-agent": ">=0.80",
-		"@earendil-works/pi-tui": ">=0.80"
+		"@earendil-works/pi-ai": ">=0.80.3",
+		"@earendil-works/pi-coding-agent": ">=0.80.3",
+		"@earendil-works/pi-tui": ">=0.80.3"
 	},
 	"pi": {
 		"extensions": [