pi-bar 0.3.44 → 0.3.45

package/README.md

@@ -43,7 +43,7 @@ The footer adapts to terminal width without extra configuration:
 - Separators have two spaces on each side by default, for a roomier display.
 - Progress text shrinks first. If space is still tight, separator padding reduces to one space per side before compacting content. CWD then compacts from its preferred path to `parent/project`, then `project`; context window size is omitted when needed. An enabled provider prefix can yield before the model name is clipped.
 - Optional token totals, cost, and cache-hit ratio yield whole under width pressure, before overflowing extension badges. Numeric metrics are never shown partially.
-- Extension badges stay in their published order. Badges that cannot fit are hidden whole, with `+N` showing how many are behind the overflow. Open `/bar status` to inspect their text and visibility by key.
+- Extension badges stay in their published order. Badges that cannot fit are hidden whole, with `+N` showing how many are behind the overflow. Open `/bar badges` to inspect their text and visibility by key.
 - On very narrow terminals, progress and CWD yield to core information. If even the core cannot fit, the model name is truncated first. At extreme widths, not every value or overflow count can remain visible.
 - Widening the terminal restores the full display. Thinking and context retain their semantic colors throughout.
 
@@ -51,24 +51,42 @@ Existing visibility settings still apply. CWD, usage metrics, and the provider p
 
 ## Customization
 
-pi-bar works out of the box. Run `/bar` inside pi to choose which footer segments and extension statuses are shown:
+**Start with `/bar`.** It opens all footer settings; you do not need to learn command groups.
 
 ```text
 /bar
 ```
 
-Toggle `Model`, `Thinking level`, `Context usage`, `Cache hit ratio`, `Estimated session cost`, `Session token totals`, `Current directory`, `Progress update`, and `Extension statuses` between `shown` and `hidden`. `Show provider` controls the optional prefix inside the model segment. `Progress model` opens a searchable model picker. If other extensions have published status badges, `/bar` also shows fine-grained `Status: <key>` rows plus a `New extension statuses` default. You can also use commands:
+Type to find a setting, then press Enter/Space to change it. Changes save immediately; Esc closes the screen rather than undoing them.
+
+Related settings stay together:
+- **Model → Show provider:** model visibility and its optional provider prefix.
+- **Progress update → Progress model:** progress visibility and a searchable model picker.
+- **Extension badges → Choose badges:** overall badge visibility and a separate screen for individual badges. Badge lists do not crowd the main settings panel. Esc from that screen returns to settings.
+
+For quick changes, Tab offers action-oriented commands with short explanations:
+
+| Command | Purpose |
+| --- | --- |
+| `/bar settings` | Open all settings, just like `/bar`. |
+| `/bar show <items>` | Show footer items. |
+| `/bar hide <items>` | Hide footer items. |
+| `/bar badges` | Choose badges published by other extensions. |
+| `/bar provider [show\|hide]` | Show, hide, or inspect the provider prefix. |
+| `/bar progress-model [auto\|provider/model]` | Choose or inspect the progress model. |
+| `/bar help` | Show commands, examples, and current visibility settings. |
 
 ```text
-/bar segments list
-/bar segments only model context
-/bar segments hide progress
-/bar segments show thinking
+/bar hide progress
+/bar show cost tokens
+/bar badges hide mcp
 ```
 
-Allowed segments are `model`, `thinking`, `context`, `cache_hit_ratio`, `cost`, `tokens`, `cwd`, `progress`, and `extensions`. The `cwd`, `cache_hit_ratio`, `cost`, and `tokens` segments are off by default. The `progress` segment stays hidden until pi-bar has a current update. The `extensions` segment stays hidden when no extension has set a status.
+Footer item names are `model`, `thinking`, `context`, `cache_hit_ratio`, `cost`, `tokens`, `cwd`, `progress`, and `extensions`. Use `/bar show all` or `/bar hide all` to change all footer items at once. `cwd`, `cache_hit_ratio`, `cost`, and `tokens` are off by default. Enabled items can still be invisible while waiting for data or when terminal space is tight.
+
+Tab completes item names, badge keys, and configured progress-model IDs while preserving preceding arguments, including comma-separated lists such as `/bar show model,ca`.
 
-Tab completes `/bar` subcommands, actions, segment names, known status keys, and configured progress-model IDs. Completion preserves preceding arguments, including comma-separated lists such as `/bar segments show model,ca`.
+**Existing commands still work:** `/bar config`, `/bar segments ...`, `/bar status ...`, and `/bar list` are compatibility aliases, not additional choices in the top-level menu. `/bar list` and `/bar segments list` only report enabled footer items. Advanced commands such as `/bar segments only model context` remain available.
 
 You can also set startup defaults with environment variables before launching pi:
 
@@ -82,7 +100,7 @@ PI_BAR_SHOW=model,context pi
 Enable the optional `cwd` segment to distinguish projects and sessions:
 
 ```text
-/bar segments show cwd
+/bar show cwd
 ```
 
 Or set startup segments with `PI_BAR_SHOW=model,thinking,context,cwd,progress,extensions`.
@@ -123,10 +141,10 @@ The prefix uses the actual model provider, not a namespace embedded in the model
 
 ### Show cache, cost, and token metrics
 
-Enable any of the optional metrics through `/bar` or the existing segment commands:
+Enable any of the optional metrics through `/bar` or the quick visibility commands:
 
 ```text
-/bar segments show cache_hit_ratio cost tokens
+/bar show cache_hit_ratio cost tokens
 ```
 
 ```text
@@ -135,7 +153,7 @@ claude-opus-4.7  ❯  think:med  ❯  2.6% / 1.0M  ❯  CH:84%  ❯  ≈$0.123
 
 | Segment | Meaning |
 | --- | --- |
-| `cache_hit_ratio` | Latest active-branch assistant prompt's cache-read percentage: `cacheRead / (input + cacheRead + cacheWrite)`. Hidden when that response has no reported prompt usage. Restored on resume and `/tree`; tool, summary, and progress calls do not replace this value. |
+| `cache_hit_ratio` | Latest active-branch assistant prompt's cache-read percentage: `cacheRead / (input + cacheRead + cacheWrite)`. Hidden when that response has no reported prompt usage. Colored green at 90% or higher, yellow from 50% up to 90%, and red below 50% (mostly cache misses). Restored on resume and `/tree`; tool, summary, and progress calls do not replace this value. |
 | `cost` | Estimated dollar cost for recorded usage in the current session file. `≈` means an estimate, **not an invoice**. |
 | `tokens` | Cumulative input (`↑`, including cache reads and writes) and output (`↓`, including reported reasoning tokens). These are usage totals, not current context size or tokens/sec. |
 
@@ -147,7 +165,7 @@ Prices come from the usage estimates Pi/providers report. Subscription allowance
 
 ### Configure live progress updates
 
-pi-bar shows a short, plain-English description of what pi is working on right now. It refreshes as pi works and resets when you switch branches in the session tree, so stale updates never follow you across tasks. Hide `Progress update` in `/bar`, run `/bar segments hide progress`, or set `PI_BAR_SHOW` without `progress` to disable it.
+pi-bar shows a short, plain-English description of what pi is working on right now. It refreshes as pi works and resets when you switch branches in the session tree, so stale updates never follow you across tasks. Hide `Progress update` in `/bar`, run `/bar hide progress`, or set `PI_BAR_SHOW` without `progress` to disable it.
 
 **Pick a model interactively:** open `/bar`, select `Progress model` directly below `Progress update`, and press Enter. Type a provider or model ID (for example `gpt`), then press Enter to select. Esc cancels without changing the preference. The picker shows models with configured Pi credentials and an `Auto` option; it does not validate keys or make model requests.
 
@@ -173,17 +191,19 @@ PI_BAR_PROGRESS_MODEL=openai/gpt-4.1-mini pi
 
 Preference order: `PI_BAR_PROGRESS_MODEL` → saved pi-bar `progressModel` → project Pi settings → global Pi settings → Auto. Within each Pi settings scope, `bar.progressModel` takes precedence over the legacy `progress.model` setting. A nonempty environment override makes both the picker and command read-only and suppresses model-value completion; unset it and restart Pi to choose another model. A saved `"auto"` explicitly enables automatic selection rather than falling back to Pi settings. Remove `progressModel` from the pi-bar config to use Pi settings again.
 
-### Configure extension statuses
+### Configure extension badges
 
 Other pi extensions can publish small status badges. Pi-bar displays their text as written, without prepending internal keys: `setStatus("mcp", "MCP: 2/2 servers")` appears as `MCP: 2/2 servers`, not `mcp:MCP: 2/2 servers`. Extensions should publish self-describing text; pi-bar does not guess labels for bare values.
 
-Pi-bar strips embedded terminal colors and control sequences, and separates each badge with the same `❯` divider used by other footer segments. Keys remain available for filtering and identification in `/bar`; selecting a status row shows its current sanitized text. Run `/bar` or `/bar status` inside pi to inspect statuses or pick which ones to show:
+Pi-bar strips embedded terminal colors and control sequences, and separates each badge with the same `❯` divider used by other footer segments. Keys remain available for filtering and identification. Open `/bar` → `Choose badges`, or use the shortcut:
 
 ```text
-/bar status
+/bar badges
 ```
 
-Toggle each status between `shown` and `hidden`. The `New statuses` row controls the default for badges that appear later.
+Each `Badge: <key>` row shows its current sanitized text when selected. Toggle badges between `shown` and `hidden`; the `New badges` row controls the default for badges discovered later without changing existing choices. An empty screen explains that extensions have not published badges yet, while still letting you set that default.
+
+These choices do not enable a hidden `Extension badges` footer item. Use `/bar show extensions` to display the badge area. `/bar badges show <keys>` and `/bar badges hide <keys>` are command shortcuts; the older `/bar status ...` spellings also work.
 
 Your choices persist across pi sessions in `~/.pi/agent/pi-bar.json`. Override the path with `PI_BAR_CONFIG=/some/path.json`.
 
@@ -208,7 +228,7 @@ npm test
 npm run check
 ```
 
-Tests cover path formatting, display-ready statuses, responsive layout, all 512 segment visibility combinations, terminal safety, ANSI/Unicode widths, provider settings, progress-model selection, command completion, usage accounting, progress-call persistence, session/tree lifecycle, and config persistence. Test configuration mirrors Pi's `pi-ai/compat` loader alias; runtime dependencies remain optional peers supplied by Pi.
+Tests cover path formatting, display-ready statuses, responsive layout, all 512 segment visibility combinations, terminal safety, ANSI/Unicode widths, provider settings, progress-model selection, menu navigation, command completion and legacy aliases, usage accounting, progress-call persistence, session/tree lifecycle, and config persistence. Test configuration mirrors Pi's `pi-ai/compat` loader alias; runtime dependencies remain optional peers supplied by Pi.
 
 ## Security note
 

package/extensions/status-footer.ts

@@ -140,8 +140,38 @@ const SEGMENT_LABELS: Record<SegmentName, string> = {
 	tokens: "Session token totals",
 	cwd: "Current directory",
 	progress: "Progress update",
-	extensions: "Extension statuses",
+	extensions: "Extension badges",
 };
+const SEGMENT_DESCRIPTIONS: Record<SegmentName, string> = {
+	model: "Show the current chat model's name. This does not change your model.",
+	thinking: "Show the current thinking level, with its usual color.",
+	context: "Show context usage and the model's context window.",
+	cache_hit_ratio: "Show the latest response's prompt cache-hit rate. Hidden until prompt usage is available.",
+	cost: "Show estimated recorded session cost, not an invoice. Hidden until usage is available.",
+	tokens: "Show recorded input and output token totals, including cache usage.",
+	cwd: "Show this session's directory, not the directory of a tool's shell.",
+	progress: "Show live activity updates. Uses extra model calls; choose the progress model below.",
+	extensions: "Show badges published by other extensions. Choose individual badges below.",
+};
+// Advertise tasks, not the legacy command groups. Old spellings still work.
+const BAR_COMMAND_DESCRIPTIONS = new Map([
+	["settings", "Open all footer settings"],
+	["show", "Show footer items"],
+	["hide", "Hide footer items"],
+	["badges", "Choose extension badges"],
+	["provider", "Show or hide provider prefix"],
+	["progress-model", "Choose progress model"],
+	["help", "Commands and examples"],
+]);
+const BAR_ACTION_DESCRIPTIONS = new Map([
+	["show", "Show selected items"],
+	["hide", "Hide selected items"],
+	["only", "Show only selected items"],
+	["all", "Show all items"],
+	["none", "Hide all items"],
+	["list", "Inspect visibility without changing it"],
+	["settings", "Open visibility settings"],
+]);
 const DEFAULT_WARNING_THRESHOLD = 70;
 const DEFAULT_ERROR_THRESHOLD = 90;
 
@@ -357,6 +387,19 @@ function contextColor(
 	return "success";
 }
 
+// Cache hit ratio is "higher is better", the inverse of context usage. A healthy
+// multi-turn conversation typically reads 90%+ of its prompt from cache; below
+// 50% means most of the prompt was billed as fresh input (a mostly-miss turn).
+const CACHE_HIT_GOOD_THRESHOLD = 90;
+const CACHE_HIT_POOR_THRESHOLD = 50;
+
+function cacheHitColor(percent: number | null | undefined): ThemeColor {
+	if (percent === null || percent === undefined) return "muted";
+	if (percent >= CACHE_HIT_GOOD_THRESHOLD) return "success";
+	if (percent >= CACHE_HIT_POOR_THRESHOLD) return "warning";
+	return "error";
+}
+
 function isSegmentName(value: string): value is SegmentName {
 	return (ALL_SEGMENTS as readonly string[]).includes(value);
 }
@@ -1834,11 +1877,11 @@ function describeSegments(segments: readonly SegmentName[]): string {
 function describeStatusFilter(filter: StatusFilter): string {
 	if (filter.mode === "only") {
 		const shown = Array.from(filter.shown).sort();
-		return shown.length > 0 ? `showing only: ${shown.join(", ")}` : "showing none";
+		return shown.length > 0 ? `showing only: ${shown.map(stripTerminalControls).join(", ")}` : "showing none";
 	}
 
 	const hidden = Array.from(filter.hidden).sort();
-	return hidden.length > 0 ? `showing all except: ${hidden.join(", ")}` : "showing all";
+	return hidden.length > 0 ? `showing all except: ${hidden.map(stripTerminalControls).join(", ")}` : "showing all";
 }
 
 function readGlobalConfig(): GlobalBarConfig {
@@ -1894,15 +1937,17 @@ export function completeBarArguments(
 	let candidates: readonly string[];
 	let selected: string[] = [];
 	let segmentValues = false;
+	let badgeValues = false;
 	let modelValues = false;
 	const section = words[0];
+	const directVisibility = section === "show" || section === "hide";
 	const segmentSection = section === "segments" || section === "segment" || section === "footer";
-	const statusSection = section === "status" || section === "statuses";
+	const statusSection = section === "badges" || section === "status" || section === "statuses";
 
 	if (words.length === 1) {
-		candidates = ["config", "segments", "status", "provider", "progress-model", "list"];
+		candidates = [...BAR_COMMAND_DESCRIPTIONS.keys()];
 	} else if (words.length === 2 && (segmentSection || statusSection)) {
-		candidates = ["list", "all", "none", "only", "show", "hide", "config"];
+		candidates = [...BAR_ACTION_DESCRIPTIONS.keys()];
 	} else if (words.length === 2 && section === "provider") {
 		candidates = ["show", "hide"];
 	} else if (words.length === 2 && section === "progress-model") {
@@ -1910,22 +1955,34 @@ export function completeBarArguments(
 		candidates = ["auto", ...[...new Set(progressModelKeys.filter(
 			(key) => typeof key === "string" && key !== "auto" && parseSerializedProgressModel(key) === key,
 		))].sort()];
-	} else if ((segmentSection || statusSection) && ["only", "show", "hide"].includes(words[1])) {
+	} else if (directVisibility || ((segmentSection || statusSection) && ["only", "show", "hide"].includes(words[1]))) {
 		const comma = fragment.lastIndexOf(",");
 		const priorValues = fragment.slice(0, comma + 1);
 		stem += priorValues;
 		fragment = fragment.slice(comma + 1);
-		selected = [...words.slice(2, -1), priorValues].join(" ").split(/[\s,]+/).filter(Boolean);
-		segmentValues = segmentSection;
+		selected = [...words.slice(directVisibility ? 1 : 2, -1), priorValues].join(" ").split(/[\s,]+/).filter(Boolean);
+		segmentValues = directVisibility || segmentSection;
+		badgeValues = !segmentValues;
 		// Keys containing delimiters/controls are still configurable in the UI,
 		// but cannot be represented safely by the existing command grammar.
-		candidates = segmentSection ? ALL_SEGMENTS : [...new Set(knownStatusKeys)].filter(
-			(key) => typeof key === "string" && key.length > 0 && !/[\s,\x00-\x1f\x7f-\x9f]/u.test(key),
-		).sort();
+		if (directVisibility && selected.some((value) => value.toLowerCase() === "all")) return null;
+		candidates = segmentValues
+			? [...(directVisibility && selected.length === 0 ? ["all"] : []), ...ALL_SEGMENTS]
+			: [...new Set(knownStatusKeys)].filter(
+				(key) => typeof key === "string" && key.length > 0 && !/[\s,\x00-\x1f\x7f-\x9f]/u.test(key),
+			).sort();
 	} else {
 		return null;
 	}
 
+	const description = (value: string): string | undefined => {
+		if (words.length === 1) return BAR_COMMAND_DESCRIPTIONS.get(value);
+		if (segmentValues) return value === "all" ? "All footer items" : isSegmentName(value) ? SEGMENT_LABELS[value] : undefined;
+		if (badgeValues) return "Extension badge";
+		if (modelValues) return value === "auto" ? "Automatic fast-model selection" : "Progress model";
+		if (section === "provider") return `${value === "show" ? "Show" : "Hide"} provider prefix`;
+		return BAR_ACTION_DESCRIPTIONS.get(value);
+	};
 	const normalize = (value: string) => segmentValues || modelValues ? value.toLowerCase() : value;
 	const used = new Set(selected.map(normalize));
 	const query = normalize(fragment);
@@ -1934,13 +1991,7 @@ export function completeBarArguments(
 			const normalized = normalize(value);
 			return (modelValues ? normalized.includes(query) : normalized.startsWith(query)) && !used.has(normalized);
 		})
-		.map((value) => ({
-			value: `${stem}${value}`,
-			label: value,
-			description: segmentValues && isSegmentName(value) ? SEGMENT_LABELS[value]
-				: modelValues ? value === "auto" ? "Automatic fast-model selection" : "Progress model"
-				: undefined,
-		}));
+		.map((value) => ({ value: `${stem}${value}`, label: value, description: description(value) }));
 	return matches.length > 0 ? matches : null;
 }
 
@@ -2035,265 +2086,167 @@ export default function (pi: ExtensionAPI) {
 		if (!previousProgressVisible && nextProgressVisible && ctx) progress.startSession(ctx.cwd);
 		refresh();
 	};
-	const openSegmentConfigurator = async (ctx: ExtensionContext) => {
+	const setBadgeVisibility = (key: string, shown: boolean) => {
+		if (statusFilter.mode === "all") {
+			if (shown) statusFilter.hidden.delete(key);
+			else statusFilter.hidden.add(key);
+		} else {
+			if (shown) statusFilter.shown.add(key);
+			else statusFilter.shown.delete(key);
+		}
+	};
+	const badgeSummary = () => {
+		const keys = getKnownStatusKeys(statusFilter, seenStatusKeys);
+		const enabled = keys.filter((key) => shouldShowStatus(key, statusFilter)).length;
+		return keys.length > 0 ? `${enabled}/${keys.length} enabled` : "No badges yet";
+	};
+	const savedSettingsTheme = (exit: "close" | "go back") => {
+		const theme = getSettingsListTheme();
+		return {
+			...theme,
+			// These toggles save immediately; Esc is not an undo operation.
+			hint: (text: string) => theme.hint(text.replace("Esc to cancel", `Esc to ${exit}`)),
+		};
+	};
+	const createBadgeSettings = (onClose: () => void, exit: "close" | "go back") => {
+		const knownKeys = getKnownStatusKeys(statusFilter, seenStatusKeys);
+		const theme = savedSettingsTheme(exit);
+		const items: SettingItem[] = [
+			{
+				id: "default:future",
+				label: "New badges",
+				description: "Default for badges discovered later. Existing badge choices stay unchanged.",
+				currentValue: statusFilter.mode === "all" ? "shown" : "hidden",
+				values: ["shown", "hidden"],
+			},
+			...knownKeys.map((key): SettingItem => ({
+				id: `badge:${key}`,
+				label: `Badge: ${stripTerminalControls(key)}`,
+				description: statusDescription(key),
+				currentValue: shouldShowStatus(key, statusFilter) ? "shown" : "hidden",
+				values: ["shown", "hidden"],
+			})),
+		];
+		const settings = new SettingsList(items, Math.min(items.length + 2, 15), theme, (id, value) => {
+			if (id === "default:future") {
+				const keys = getKnownStatusKeys(statusFilter, seenStatusKeys);
+				statusFilter = value === "shown"
+					? { mode: "all", hidden: new Set(keys.filter((key) => !shouldShowStatus(key, statusFilter))) }
+					: { mode: "only", shown: new Set(keys.filter((key) => shouldShowStatus(key, statusFilter))) };
+			} else {
+				setBadgeVisibility(id.slice("badge:".length), value === "shown");
+			}
+			persistStatusFilter();
+		}, onClose, { enableSearch: true });
+		return {
+			render(width: number) {
+				return [
+					theme.label("Extension badges", true),
+					theme.hint(knownKeys.length > 0
+						? "Choose badges by key; select a row to preview its text."
+						: "No badges yet. Extensions publish them while you work."),
+					theme.hint("Changes save immediately."),
+					...(!visibleSegments.includes("extensions")
+						? [theme.hint("All badges are hidden. Use /bar show extensions to display them.")]
+						: []),
+					"",
+					...settings.render(Math.max(8, width)),
+				].map((line) => truncateToWidth(line, Math.max(0, width)));
+			},
+			invalidate() { settings.invalidate(); },
+			handleInput(data: string) { settings.handleInput(data); },
+		};
+	};
+	const openSettings = async (ctx: ExtensionContext) => {
 		if (ctx.mode !== "tui") {
-			ctx.ui.notify("/bar configuration requires TUI mode", "warning");
+			ctx.ui.notify("/bar settings requires TUI mode", "warning");
 			return;
 		}
 		await ctx.ui.custom((tui, theme, _kb, done) => {
-			const knownStatusKeys = getKnownStatusKeys(statusFilter, seenStatusKeys);
-			const segmentVisibility = new Map(
-				ALL_SEGMENTS.map(
-					(segment): [SegmentName, boolean] => [segment, visibleSegments.includes(segment)],
-				),
-			);
-			let futureShown = statusFilter.mode === "all";
-			const statusVisibility = new Map(
-				knownStatusKeys.map((key): [string, boolean] => [
-					key,
-					shouldShowStatus(key, statusFilter),
-				]),
-			);
-			const persistSegmentsFromVisibility = () => {
-				setVisibleSegments(
-					ALL_SEGMENTS.filter((segment) => segmentVisibility.get(segment)),
-					ctx,
-				);
-			};
-			const persistStatusesFromVisibility = () => {
-				if (futureShown) {
-					statusFilter = {
-						mode: "all",
-						hidden: new Set(
-							knownStatusKeys.filter((key) => !statusVisibility.get(key)),
-						),
-					};
-				} else {
-					statusFilter = {
-						mode: "only",
-						shown: new Set(
-							knownStatusKeys.filter((key) => statusVisibility.get(key)),
-						),
-					};
-				}
-				persistStatusFilter();
-			};
-
-			const segmentItems: SettingItem[] = ALL_SEGMENTS.flatMap((segment): SettingItem[] => {
-				const visibilityItem: SettingItem = {
+			const items = ALL_SEGMENTS.flatMap((segment): SettingItem[] => {
+				const group: SettingItem[] = [{
 					id: `segment:${segment}`,
 					label: SEGMENT_LABELS[segment],
-					description: "Footer segment visibility",
-					currentValue: segmentVisibility.get(segment) ? "shown" : "hidden",
+					description: SEGMENT_DESCRIPTIONS[segment],
+					currentValue: visibleSegments.includes(segment) ? "shown" : "hidden",
 					values: ["shown", "hidden"],
-				};
-				if (segment !== "progress") return [visibilityItem];
-				return [visibilityItem, {
+				}];
+				if (segment === "model") group.push({
+					id: "show-provider",
+					label: "Show provider",
+					description: "Prefix the model name with its provider. Only visible when Model is shown.",
+					currentValue: showProvider ? "shown" : "hidden",
+					values: ["shown", "hidden"],
+				});
+				if (segment === "progress") group.push({
 					id: "progress-model",
 					label: "Progress model",
 					description: process.env.PI_BAR_PROGRESS_MODEL
 						? "Controlled by PI_BAR_PROGRESS_MODEL (read-only). Unset it and restart Pi to choose here."
-						: "Choose Auto or search models with configured Pi credentials. Saved for all projects; changes only progress updates.",
+						: "Choose Auto or search models with configured Pi credentials. Changes only progress updates, not the chat model.",
 					currentValue: formatProgressModelKey(resolveProgressModelPreference(ctx.cwd)),
 					submenu: process.env.PI_BAR_PROGRESS_MODEL
 						? undefined
 						: (currentValue, close) => createProgressModelPicker(ctx, currentValue, close),
-				}];
+				});
+				if (segment === "extensions") group.push({
+					id: "badge-settings",
+					label: "Choose badges",
+					description: "Choose individual badges from other extensions. They display only when Extension badges is shown.",
+					currentValue: badgeSummary(),
+					submenu: (_currentValue, close) => createBadgeSettings(() => close(badgeSummary()), "go back"),
+				});
+				return group;
 			});
-			const statusItems: SettingItem[] = knownStatusKeys.length > 0
-				? [
-					{
-						id: "status:__future",
-						label: "New extension statuses",
-						description: "Default visibility for status keys discovered later",
-						currentValue: futureShown ? "shown" : "hidden",
-						values: ["shown", "hidden"],
-					},
-					...knownStatusKeys.map((key): SettingItem => ({
-						id: `status:${key}`,
-						label: `Status: ${stripTerminalControls(key)}`,
-						description: statusDescription(key),
-						currentValue: statusVisibility.get(key) ? "shown" : "hidden",
-						values: ["shown", "hidden"],
-					})),
-				]
-				: [];
-			const items: SettingItem[] = [
-				...segmentItems,
-				{
-					id: "show-provider",
-					label: "Show provider",
-					description: "Provider prefix inside the model segment (hidden by default)",
-					currentValue: showProvider ? "shown" : "hidden",
-					values: ["shown", "hidden"],
-				},
-				...statusItems,
-			];
-
 			const container = new Container();
-			container.addChild(
-				new (class {
-					render(_width: number) {
-						return [
-							theme.fg("accent", theme.bold("pi-bar configuration")),
-							theme.fg(
-								"dim",
-								knownStatusKeys.length > 0
-									? "Footer settings + extension statuses · Enter/Space changes · Esc closes"
-									: "Footer settings · Enter/Space changes · Esc closes",
-							),
-							"",
-						];
-					}
-					invalidate() {}
-				})(),
-			);
-
-			const settingsList = new SettingsList(
-				items,
-				Math.min(items.length + 2, 18),
-				getSettingsListTheme(),
-				(id, newValue) => {
-					if (id === "progress-model") {
-						setProgressModel(newValue, ctx);
-						settingsList.updateValue(id, formatProgressModelKey(resolveProgressModelPreference(ctx.cwd)));
-						return;
-					}
-					if (id === "show-provider") {
-						setShowProvider(newValue === "shown");
-						return;
-					}
-					if (id.startsWith("segment:")) {
-						const segment = id.slice("segment:".length);
-						if (!isSegmentName(segment)) return;
-						segmentVisibility.set(segment, newValue === "shown");
-						persistSegmentsFromVisibility();
-						return;
-					}
-
-					if (id === "status:__future") {
-						futureShown = newValue === "shown";
-						persistStatusesFromVisibility();
-						return;
-					}
-
-					if (id.startsWith("status:")) {
-						statusVisibility.set(id.slice("status:".length), newValue === "shown");
-						persistStatusesFromVisibility();
-					}
-				},
-				() => done(undefined),
-				{ enableSearch: true },
-			);
-
-			container.addChild(settingsList);
-
+			container.addChild(new (class {
+				render(_width: number) {
+					return [
+						theme.fg("accent", theme.bold("pi-bar settings")),
+						theme.fg("dim", "Choose what appears in your footer. Changes save immediately."),
+						"",
+					];
+				}
+				invalidate() {}
+			})());
+			const settings = new SettingsList(items, Math.min(items.length + 2, 18), savedSettingsTheme("close"), (id, value) => {
+				if (id === "progress-model") {
+					setProgressModel(value, ctx);
+					settings.updateValue(id, formatProgressModelKey(resolveProgressModelPreference(ctx.cwd)));
+				} else if (id === "show-provider") {
+					setShowProvider(value === "shown");
+				} else if (id.startsWith("segment:")) {
+					const segment = id.slice("segment:".length);
+					if (!isSegmentName(segment)) return;
+					setVisibleSegments(value === "shown"
+						? [...visibleSegments, segment]
+						: visibleSegments.filter((item) => item !== segment), ctx);
+				}
+			}, () => done(undefined), { enableSearch: true });
+			container.addChild(settings);
 			return {
 				render(width: number) {
 					return container.render(Math.max(8, width)).map((line) => truncateToWidth(line, Math.max(0, width)));
 				},
-				invalidate() {
-					container.invalidate();
-				},
+				invalidate() { container.invalidate(); },
 				handleInput(data: string) {
-					settingsList.handleInput?.(data);
+					settings.handleInput(data);
 					tui.requestRender();
 				},
 			};
 		});
 	};
-	const openStatusConfigurator = async (ctx: ExtensionContext) => {
-		const knownStatusKeys = getKnownStatusKeys(statusFilter, seenStatusKeys);
-		if (knownStatusKeys.length === 0) {
-			ctx.ui.notify(
-				"No extension statuses seen yet. Open /bar after another extension calls ctx.ui.setStatus().",
-				"info",
-			);
+	const openBadges = async (ctx: ExtensionContext) => {
+		if (ctx.mode !== "tui") {
+			ctx.ui.notify("/bar badges requires TUI mode", "warning");
 			return;
 		}
-
-		await ctx.ui.custom((tui, theme, _kb, done) => {
-			let futureShown = statusFilter.mode === "all";
-			const statusVisibility = new Map(
-				knownStatusKeys.map((key) => [key, shouldShowStatus(key, statusFilter)]),
-			);
-			const persistFromVisibility = () => {
-				if (futureShown) {
-					statusFilter = {
-						mode: "all",
-						hidden: new Set(
-							knownStatusKeys.filter((key) => !statusVisibility.get(key)),
-						),
-					};
-				} else {
-					statusFilter = {
-						mode: "only",
-						shown: new Set(
-							knownStatusKeys.filter((key) => statusVisibility.get(key)),
-						),
-					};
-				}
-				persistStatusFilter();
-			};
-
-			const items: SettingItem[] = [
-				{
-					id: "__future",
-					label: "New statuses",
-					description: "Default visibility for status keys discovered later",
-					currentValue: futureShown ? "shown" : "hidden",
-					values: ["shown", "hidden"],
-				},
-				...knownStatusKeys.map((key): SettingItem => ({
-					id: key,
-					label: stripTerminalControls(key),
-					description: statusDescription(key),
-					currentValue: statusVisibility.get(key) ? "shown" : "hidden",
-					values: ["shown", "hidden"],
-				})),
-			];
-
-			const container = new Container();
-			container.addChild(
-				new (class {
-					render(_width: number) {
-						return [
-							theme.fg("accent", theme.bold("pi-bar status visibility")),
-							theme.fg("dim", "Enter/Space toggles · Esc closes"),
-							"",
-						];
-					}
-					invalidate() {}
-				})(),
-			);
-
-			const settingsList = new SettingsList(
-				items,
-				Math.min(items.length + 2, 15),
-				getSettingsListTheme(),
-				(id, newValue) => {
-					if (id === "__future") {
-						futureShown = newValue === "shown";
-					} else {
-						statusVisibility.set(id, newValue === "shown");
-					}
-					persistFromVisibility();
-				},
-				() => done(undefined),
-				{ enableSearch: true },
-			);
-
-			container.addChild(settingsList);
-
+		await ctx.ui.custom((tui, _theme, _kb, done) => {
+			const settings = createBadgeSettings(() => done(undefined), "close");
 			return {
-				render(width: number) {
-					return container.render(width);
-				},
-				invalidate() {
-					container.invalidate();
-				},
+				...settings,
 				handleInput(data: string) {
-					settingsList.handleInput?.(data);
+					settings.handleInput(data);
 					tui.requestRender();
 				},
 			};
@@ -2301,7 +2254,7 @@ export default function (pi: ExtensionAPI) {
 	};
 
 	pi.registerCommand("bar", {
-		description: "Configure pi-bar footer",
+		description: "Open footer settings; choose what appears in the bar",
 		getArgumentCompletions: (prefix) => {
 			let modelKeys: string[] = [];
 			if (/^\s*progress-model\s+\S*$/.test(prefix)) {
@@ -2313,15 +2266,55 @@ export default function (pi: ExtensionAPI) {
 			return completeBarArguments(prefix, getKnownStatusKeys(statusFilter, seenStatusKeys), modelKeys);
 		},
 		handler: async (args, ctx) => {
-			const [section, action, ...rest] = args.trim().split(/\s+/).filter(Boolean);
-			if (!section || section === "config" || section === "configure" || section === "edit") {
-				await openSegmentConfigurator(ctx);
+			const words = args.trim().split(/\s+/).filter(Boolean);
+			if (words[0] === "show" || words[0] === "hide") {
+				const names = splitStatusKeys(words.slice(1).join(" ")).map((name) => name.toLowerCase());
+				if (names.includes("all")) {
+					if (names.length !== 1) {
+						ctx.ui.notify("Use all by itself: /bar show all or /bar hide all.", "warning");
+						return;
+					}
+					words.splice(0, words.length, "segments", words[0] === "show" ? "all" : "none");
+				} else {
+					const unknown = names.filter((name) => !isSegmentName(name));
+					if (unknown.length > 0) {
+						ctx.ui.notify(`Unknown footer items: ${unknown.map(stripTerminalControls).join(", ")}. Use Tab to choose items.`, "warning");
+						return;
+					}
+					words.unshift("segments");
+				}
+			}
+			if (words[0] === "badges") {
+				if (["show", "hide", "only"].includes(words[1]) && splitStatusKeys(words.slice(2).join(" ")).length === 0) {
+					ctx.ui.notify("Choose badge keys with Tab, or open /bar badges to choose them interactively.", "warning");
+					return;
+				}
+				words[0] = "status";
+			}
+			const [section, action, ...rest] = words;
+			if (!section || section === "settings" || section === "config" || section === "configure" || section === "edit") {
+				await openSettings(ctx);
 				return;
 			}
 			if (section === "list" || section === "ls") {
 				ctx.ui.notify(`pi-bar footer: ${describeSegments(visibleSegments)}`, "info");
 				return;
 			}
+			if (section === "help") {
+				ctx.ui.notify([
+					"Open /bar for all footer settings. Changes save immediately.",
+					"",
+					...Array.from(BAR_COMMAND_DESCRIPTIONS, ([name, description]) => `/bar ${name} — ${description}`),
+					"",
+					"Examples: /bar show cost tokens · /bar hide progress · /bar badges hide mcp",
+					"Use /bar show all or /bar hide all to change every footer item.",
+					`Footer items: ${ALL_SEGMENTS.join(", ")}`,
+					`Current configuration: ${describeSegments(visibleSegments)}`,
+					"Enabled items may wait for data or yield under width pressure.",
+					"Old commands still work: /bar config, /bar segments, /bar status, /bar list.",
+				].join("\n"), "info");
+				return;
+			}
 
 			if (section === "progress-model") {
 				if (!action) {
@@ -2359,7 +2352,7 @@ export default function (pi: ExtensionAPI) {
 				const segments = splitSegmentNames(rest.join(" "));
 				if ((action === "only" || action === "show" || action === "hide") && segments.length === 0) {
 					ctx.ui.notify(
-						`Segments: ${ALL_SEGMENTS.join(", ")}`,
+						`Footer items: ${ALL_SEGMENTS.join(", ")}. Use Tab to choose.`,
 						"warning",
 					);
 					return;
@@ -2367,10 +2360,11 @@ export default function (pi: ExtensionAPI) {
 
 				switch (action) {
 					case undefined:
+					case "settings":
 					case "config":
 					case "configure":
 					case "edit":
-						await openSegmentConfigurator(ctx);
+						await openSettings(ctx);
 						return;
 					case "list":
 					case "ls":
@@ -2396,7 +2390,7 @@ export default function (pi: ExtensionAPI) {
 						break;
 					default:
 						ctx.ui.notify(
-							"Usage: /bar [config] or /bar segments [list|all|none|only <segments>|show <segments>|hide <segments>]",
+							"Use /bar show <items> or /bar hide <items>. Open /bar for all settings.",
 							"warning",
 						);
 						return;
@@ -2407,7 +2401,7 @@ export default function (pi: ExtensionAPI) {
 			}
 
 			if ((section === "status" || section === "statuses") && !action) {
-				await openStatusConfigurator(ctx);
+				await openBadges(ctx);
 				return;
 			}
 
@@ -2415,16 +2409,17 @@ export default function (pi: ExtensionAPI) {
 				const keys = splitStatusKeys(rest.join(" "));
 
 				switch (action) {
+					case "settings":
 					case "config":
 					case "configure":
 					case "edit":
-						await openStatusConfigurator(ctx);
+						await openBadges(ctx);
 						return;
 					case "list":
 					case "ls": {
 						const known = getKnownStatusKeys(statusFilter, seenStatusKeys);
 						ctx.ui.notify(
-							`pi-bar statuses: ${describeStatusFilter(statusFilter)}${known.length > 0 ? `; known: ${known.join(", ")}` : "; known: none yet"}`,
+							`pi-bar badges: ${describeStatusFilter(statusFilter)}${known.length > 0 ? `; known: ${known.map(stripTerminalControls).join(", ")}` : "; known: none yet"}`,
 							"info",
 						);
 						return;
@@ -2439,34 +2434,24 @@ export default function (pi: ExtensionAPI) {
 						statusFilter = { mode: "only", shown: new Set(keys) };
 						break;
 					case "hide":
-						if (statusFilter.mode === "only") {
-							for (const key of keys) statusFilter.shown.delete(key);
-						} else {
-							for (const key of keys) statusFilter.hidden.add(key);
-						}
-						break;
 					case "show":
-						if (statusFilter.mode === "only") {
-							for (const key of keys) statusFilter.shown.add(key);
-						} else {
-							for (const key of keys) statusFilter.hidden.delete(key);
-						}
+						for (const key of keys) setBadgeVisibility(key, action === "show");
 						break;
 					default:
 						ctx.ui.notify(
-							"Usage: /bar status [list|all|none|only <keys>|show <keys>|hide <keys>]",
+							"Open /bar badges to choose badges, or use /bar badges show|hide <keys>.",
 							"warning",
 						);
 						return;
 				}
 
 				persistStatusFilter();
-				ctx.ui.notify(`pi-bar statuses: ${describeStatusFilter(statusFilter)}`, "info");
+				ctx.ui.notify(`pi-bar badges: ${describeStatusFilter(statusFilter)}`, "info");
 				return;
 			}
 
 			ctx.ui.notify(
-				"Usage: /bar [config] or /bar segments [list|all|none|only <segments>|show <segments>|hide <segments>] or /bar status [list|all|none|only <keys>|show <keys>|hide <keys>] or /bar provider [show|hide] or /bar progress-model [auto|provider/model]",
+				"Unknown /bar command. Open /bar for settings or /bar help for examples.",
 				"warning",
 			);
 		},
@@ -2580,7 +2565,7 @@ export default function (pi: ExtensionAPI) {
 							alternatives: [theme.fg(contextSegmentColor, contextCompact)],
 						},
 						cache_hit_ratio: {
-							text: metrics.cacheHitRate === null ? "" : theme.fg("muted", `CH:${metrics.cacheHitRate.toFixed(1).replace(/\.0$/, "")}%`),
+							text: metrics.cacheHitRate === null ? "" : theme.fg(cacheHitColor(metrics.cacheHitRate), `CH:${metrics.cacheHitRate.toFixed(1).replace(/\.0$/, "")}%`),
 						},
 						cost: { text: reportedUsage ? theme.fg("muted", `≈$${metrics.cost.toFixed(3)}`) : "" },
 						tokens: { text: reportedUsage ? theme.fg("muted", `↑${formatTokens(metrics.input)} ↓${formatTokens(metrics.output)}`) : "" },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-bar",
-  "version": "0.3.44",
+  "version": "0.3.45",
   "description": "Pi footer/statusline showing active model, thinking level, context pressure, live progress updates, and extension statuses.",
   "type": "module",
   "keywords": [