pi-cockpit 0.14.0 → 0.16.0

package/README.md

@@ -66,6 +66,7 @@ Cockpit has no package dependency on `pi-maestro-flow`. It observes optional pro
   "agentsMode": "list",
   "todoMode": "list",
   "todoExpanded": false,
+  "stackStyle": "classic",
   "hideNativeAgents": true,
   "icons": { "mode": "auto" },
   "sidebar": {
@@ -91,6 +92,7 @@ Cockpit has no package dependency on `pi-maestro-flow`. It observes optional pro
 - `quietSymbols`: `"check"` (✓/✗/⋯) or `"dot"` (●/○/◌) lifecycle glyphs for quiet tool rows.
 - `agentsMode` / `todoMode`: `"list"` or `"compact"`.
 - `todoExpanded`: when `true`, expands the todo widget by default.
+- `stackStyle`: `"classic"` keeps the separate Todo/Agent widgets; `"zen"` projects MISSION, WORK, and ACTORS into one borderless stack. The default remains `"classic"`.
 - `hideNativeAgents`: when `true`, clears the teammate extension's own `teammate-agents` widget (it draws a similar list *below* the editor) so the two don't duplicate. On by default.
 - `sidebar.mode`: `"auto"` or `"on"` enables the dock when at least 72 main columns plus 32 sidebar columns fit; `"off"` always uses widgets.
 - `sidebar.width`: persisted dock width, rounded and clamped to `32..56`; default `40`.
@@ -114,11 +116,12 @@ The tab title is `frame + pi - <session> - <working state>`. The session part fo
 - `/cockpit` — opens the settings overlay.
 - `/maestro-settings` — opens the unified settings shell (Cockpit, Flow, Teammate and integrations).
 - `Alt+J` — opens the background Bash jobs overlay (live status, command, cwd, duration, output tail).
+- `Alt+L` — browses the visible Cockpit surface. In Zen widget mode, arrows or `j/k` select rows, first Enter expands inline details, second Enter opens the entity sheet/overlay, and Esc steps back. In the Agent overlay, `m` makes the selected agent the editor input target.
 - `/cockpit sidebar` — reports the current sidebar mode, width, and density.
 - `/cockpit sidebar auto|on|off` — selects dock behavior.
 - `/cockpit sidebar resize` or `Ctrl+Shift+R` — enters temporary Resize mode. Left/Right adjusts one column, Shift+Left/Shift+Right adjusts four, Enter accepts, and Escape rolls back. Mouse reporting is active only during Resize mode.
 - `/cockpit quiet` — toggles quiet mode; `/cockpit bg` shows background jobs.
-- `/theme` — switch theme with live preview; `/theme <name>` applies directly. Pi ships no standalone theme command; cockpit provides one.
+- `/theme` — switch theme with live preview; `/theme <name>` applies directly. `cockpit-zen` is the restrained warm-gold theme designed for the Zen stack; selecting it does not change `stackStyle`. Pi ships no standalone theme command; cockpit provides one.
 
 ## Sidebar compatibility
 

package/package.json

@@ -1,85 +1,85 @@
-{
-  "name": "pi-cockpit",
-  "version": "0.14.0",
-  "description": "Responsive Maestro operations sidebar, fallback status widgets, and footer for Pi.",
-  "type": "module",
-  "keywords": [
-    "pi-package",
-    "pi",
-    "pi-extension",
-    "tui",
-    "teammate",
-    "todo"
-  ],
-  "license": "MIT",
-  "files": [
-    "src/",
-    "themes/",
-    "README.md"
-  ],
-  "scripts": {
-    "test": "node --test --experimental-transform-types tests/config.test.ts tests/public-events.test.ts tests/maestro-store.test.ts tests/split-pane.test.ts tests/editor-bottom.test.ts tests/sidebar-render.test.ts tests/sidebar-controller.test.ts tests/viewport-stability.test.ts tests/quiet-tools.test.ts tests/edit-guard.test.ts tests/agents-store.test.ts tests/endpoint-store.test.ts tests/session-ui-state.test.ts tests/session-tabs.test.ts tests/agent-bar.test.ts tests/supervision-store.test.ts tests/bash-bg-store.test.ts tests/bash-bg-widget.test.ts tests/bash-bg-overlay.test.ts tests/agent-overlay.test.ts tests/todo-store.test.ts tests/render.test.ts tests/agent-scroll.test.ts tests/session-bar.test.ts tests/session-detail.test.ts tests/footer.test.ts tests/extension-status.test.ts tests/input-routing.test.ts tests/integration-contract.test.ts tests/stack-widget.test.ts tests/settings-view.test.ts tests/thinking-fold.test.ts tests/thinking-timer.test.ts tests/tick-policy.test.ts tests/ambient.test.ts tests/viewport.test.ts tests/theme-picker.test.ts tests/model-picker.test.ts tests/title-gen.test.ts tests/title-llm.test.ts tests/settings-registry.test.ts tests/settings-coordinator.test.ts tests/settings-locale.test.ts tests/tui-i18n.test.ts tests/settings-shell.test.ts tests/settings-cockpit-provider.test.ts tests/settings-cross-package.test.ts tests/ui-primitives.test.ts tests/settings-shell-secret.test.ts tests/settings-shell-listcrud.test.ts tests/capturing-overlay.test.ts tests/claude-editor.test.ts tests/fullscreen-controller.test.ts tests/transcript-selection.test.ts tests/terminal-cleanup.test.ts tests/terminal-capability.test.ts",
-    "typecheck": "tsc --noEmit",
-    "prepack": "node ../../scripts/bundle-settings-core.mjs",
-    "postpack": "node ../../scripts/bundle-settings-core.mjs --clean"
-  },
-  "pi": {
-    "extensions": [
-      "./src/extension/index.ts"
-    ],
-    "themes": [
-      "./themes"
-    ]
-  },
-  "dependencies": {
-    "pi-maestro-settings-core": "0.1.3",
-    "proper-lockfile": "4.1.2"
-  },
-  "bundledDependencies": [
-    "pi-maestro-settings-core"
-  ],
-  "peerDependencies": {
-    "@earendil-works/pi-agent-core": "*",
-    "@earendil-works/pi-ai": "*",
-    "@earendil-works/pi-coding-agent": "*",
-    "@earendil-works/pi-tui": "*",
-    "pi-maestro-teammate": "^1.6.0",
-    "typebox": "*"
-  },
-  "peerDependenciesMeta": {
-    "@earendil-works/pi-agent-core": {
-      "optional": true
-    },
-    "@earendil-works/pi-ai": {
-      "optional": true
-    },
-    "@earendil-works/pi-coding-agent": {
-      "optional": true
-    },
-    "@earendil-works/pi-tui": {
-      "optional": true
-    },
-    "pi-maestro-teammate": {
-      "optional": true
-    },
-    "typebox": {
-      "optional": true
-    }
-  },
-  "devDependencies": {
-    "@earendil-works/pi-agent-core": "0.83.0",
-    "@earendil-works/pi-ai": "0.83.0",
-    "@earendil-works/pi-coding-agent": "0.83.0",
-    "@earendil-works/pi-tui": "0.83.0",
-    "@types/node": "^22.0.0",
-    "pi-maestro-teammate": "1.12.0",
-    "typebox": "1.3.7",
-    "typescript": "^5.5.0"
-  },
-  "main": "./src/index.ts",
-  "exports": {
-    ".": "./src/index.ts",
-    "./v1/events": "./src/public/v1/events.ts",
-    "./src/*": "./src/*"
-  }
-}
+{
+  "name": "pi-cockpit",
+  "version": "0.16.0",
+  "description": "Responsive Maestro operations sidebar, fallback status widgets, and footer for Pi.",
+  "type": "module",
+  "keywords": [
+    "pi-package",
+    "pi",
+    "pi-extension",
+    "tui",
+    "teammate",
+    "todo"
+  ],
+  "license": "MIT",
+  "files": [
+    "src/",
+    "themes/",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "node --test --experimental-transform-types tests/config.test.ts tests/public-events.test.ts tests/maestro-store.test.ts tests/split-pane.test.ts tests/editor-bottom.test.ts tests/sidebar-render.test.ts tests/sidebar-controller.test.ts tests/viewport-stability.test.ts tests/quiet-tools.test.ts tests/edit-guard.test.ts tests/agents-store.test.ts tests/endpoint-store.test.ts tests/session-ui-state.test.ts tests/session-tabs.test.ts tests/agent-bar.test.ts tests/supervision-store.test.ts tests/bash-bg-store.test.ts tests/bash-bg-widget.test.ts tests/bash-bg-overlay.test.ts tests/agent-overlay.test.ts tests/todo-store.test.ts tests/render.test.ts tests/agent-scroll.test.ts tests/session-bar.test.ts tests/session-detail.test.ts tests/footer.test.ts tests/extension-status.test.ts tests/input-routing.test.ts tests/input-history-store.test.ts tests/unified-editor.test.ts tests/integration-contract.test.ts tests/stack-widget.test.ts tests/zen-render.test.ts tests/zen-browse.test.ts tests/zen-sheet.test.ts tests/settings-view.test.ts tests/thinking-fold.test.ts tests/thinking-timer.test.ts tests/tick-policy.test.ts tests/ambient.test.ts tests/viewport.test.ts tests/theme-picker.test.ts tests/model-picker.test.ts tests/title-gen.test.ts tests/title-llm.test.ts tests/settings-registry.test.ts tests/settings-coordinator.test.ts tests/settings-locale.test.ts tests/tui-i18n.test.ts tests/settings-shell.test.ts tests/settings-cockpit-provider.test.ts tests/settings-cross-package.test.ts tests/ui-primitives.test.ts tests/settings-shell-secret.test.ts tests/settings-shell-listcrud.test.ts tests/capturing-overlay.test.ts tests/claude-editor.test.ts tests/fullscreen-controller.test.ts tests/transcript-selection.test.ts tests/terminal-cleanup.test.ts tests/terminal-capability.test.ts",
+    "typecheck": "tsc --noEmit",
+    "prepack": "node ../../scripts/bundle-settings-core.mjs",
+    "postpack": "node ../../scripts/bundle-settings-core.mjs --clean"
+  },
+  "pi": {
+    "extensions": [
+      "./src/extension/index.ts"
+    ],
+    "themes": [
+      "./themes"
+    ]
+  },
+  "dependencies": {
+    "pi-maestro-settings-core": "0.1.3",
+    "proper-lockfile": "4.1.2"
+  },
+  "bundledDependencies": [
+    "pi-maestro-settings-core"
+  ],
+  "peerDependencies": {
+    "@earendil-works/pi-agent-core": "*",
+    "@earendil-works/pi-ai": "*",
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*",
+    "pi-maestro-teammate": "^1.6.0",
+    "typebox": "*"
+  },
+  "peerDependenciesMeta": {
+    "@earendil-works/pi-agent-core": {
+      "optional": true
+    },
+    "@earendil-works/pi-ai": {
+      "optional": true
+    },
+    "@earendil-works/pi-coding-agent": {
+      "optional": true
+    },
+    "@earendil-works/pi-tui": {
+      "optional": true
+    },
+    "pi-maestro-teammate": {
+      "optional": true
+    },
+    "typebox": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@earendil-works/pi-agent-core": "0.83.0",
+    "@earendil-works/pi-ai": "0.83.0",
+    "@earendil-works/pi-coding-agent": "0.83.0",
+    "@earendil-works/pi-tui": "0.83.0",
+    "@types/node": "^22.0.0",
+    "pi-maestro-teammate": "1.13.0",
+    "typebox": "1.3.7",
+    "typescript": "^5.5.0"
+  },
+  "main": "./src/index.ts",
+  "exports": {
+    ".": "./src/index.ts",
+    "./v1/events": "./src/public/v1/events.ts",
+    "./src/*": "./src/*"
+  }
+}

package/src/agent-overlay.ts

@@ -9,7 +9,7 @@ import {
 	truncateToWidth,
 	visibleWidth,
 } from "@earendil-works/pi-tui";
-import { effectiveAgentStatus, type AgentDisplayStatus } from "./agents-store.ts";
+import { effectiveAgentStatus, isExpertLeader, type AgentDisplayStatus } from "./agents-store.ts";
 import { scrollBy, type AgentScrollState } from "./agent-scroll.ts";
 import type { IconGlyphs } from "./icons.ts";
 import { visibleStart } from "./layout.ts";
@@ -28,6 +28,8 @@ export interface AgentOverlayParams {
 	getAgents: () => readonly AgentRow[];
 	getViewingId: () => string | undefined;
 	onSelect: (correlationId: string) => void;
+	/** Set the selected agent as the editor input target without closing the overlay. */
+	onTarget?: (correlationId: string) => void;
 	onCommand: (correlationId: string, action: "interrupt" | "steer", message?: string) => void;
 	requestRender: () => void;
 	close: () => void;
@@ -289,6 +291,11 @@ export class AgentOverlay implements Component, Focusable {
 			this.scrollOutput(Math.max(1, this.detailRows - 2));
 			return;
 		}
+		if (commandInput === "m" && this.selectedId && this.params.onTarget) {
+			this.params.onTarget(this.selectedId);
+			this.ack(tuiT("overlay.agents.targetAck", { agent: this.agentName(this.selectedId) }));
+			return;
+		}
 		if (commandInput === "i" && this.selectedId) {
 			// Interrupt (打断): abort the current turn/tool; the agent stays alive
 			// and is told to report and continue.
@@ -444,8 +451,11 @@ export class AgentOverlay implements Component, Focusable {
 			const visual = agentVisual(status, this.params.glyphs);
 			const marker = row.correlationId === this.selectedId ? this.params.glyphs.selectMarker : " ";
 			const task = row.task ? ` · ${row.task}` : "";
+			const expertTag = isExpertLeader(row)
+				? `${this.params.theme.fg("accent", tuiT("widget.agent.expert"))} `
+				: "";
 			return fit(
-				`${prefix}${marker} ${this.params.theme.fg(visual.color, visual.glyph)} ${this.params.theme.bold(agentLabel(row))}${task}`,
+				`${prefix}${marker} ${this.params.theme.fg(visual.color, visual.glyph)} ${expertTag}${this.params.theme.bold(agentLabel(row))}${task}`,
 				width,
 			);
 		});

package/src/agents-store.ts

@@ -5,7 +5,7 @@ import type {
 } from "pi-maestro-teammate/v1/events";
 import type { AgentProgressSnapshot } from "pi-maestro-teammate/v1/types";
 import { sanitizeExtensionStatusText } from "./extension-status.ts";
-import type { AgentRow, AgentStatus } from "./types.ts";
+import { EXPERT_LEADER_NAME, type AgentRow, type AgentStatus } from "./types.ts";
 
 const STATUS_TEXT_MAX = 48;
 const TEAMMATE_STALL_TIMEOUT_MS = 30_000;
@@ -99,6 +99,16 @@ function deriveRole(agent: string | undefined, name: string | undefined): string
 	return clean(name) || "agent";
 }
 
+/**
+ * True when the row is the workflow Leader of an expert-mode dispatch
+ * (pi-maestro-teammate EXPERT_MODE_LEADER_NAME). The Leader keeps the same
+ * tree + dependency-arrow presentation as parallel/DAG runs; this only adds
+ * its strategy marker.
+ */
+export function isExpertLeader(row: { name: string | undefined }): boolean {
+	return row.name === EXPERT_LEADER_NAME;
+}
+
 export function mapAgentStatus(status: unknown): AgentStatus {
 	switch (status) {
 		case "pending":

package/src/bash-bg-overlay.ts

@@ -25,6 +25,8 @@ export interface BashBgOverlayParams {
 	close: () => void;
 	theme: Theme;
 	glyphs: IconGlyphs;
+	/** Select this job when the overlay first renders. */
+	initialJobId?: string;
 	/** Wall-clock snapshot supplied by the owner and advanced through tick(). */
 	now: number;
 	/** Live terminal height, so the card can use the space it already reserves. */
@@ -57,6 +59,7 @@ export class BashBgOverlay implements Component, Focusable {
 	constructor(private readonly params: BashBgOverlayParams) {
 		this.now = params.now;
 		this.liveTickKey = this.tickKey(params.now);
+		this.selectedId = params.initialJobId;
 	}
 
 	invalidate(): void {}

package/src/claude-editor.ts

@@ -1,6 +1,7 @@
 import { CustomEditor, type KeybindingsManager } from "@earendil-works/pi-coding-agent";
-import { isKeyRelease, isKeyRepeat, matchesKey, type EditorTheme, type TUI } from "@earendil-works/pi-tui";
+import { isKeyRelease, isKeyRepeat, matchesKey, getKeybindings, truncateToWidth, visibleWidth, type EditorTheme, type TUI } from "@earendil-works/pi-tui";
 import { readAutocompleteState } from "./autocomplete-probe.ts";
+import { tuiT } from "./tui-i18n.ts";
 
 /** Invisible editor start marker consumed by the fullscreen controller (fullscreenInput only). */
 export const EDITOR_START_SENTINEL = "\u2063\u2064\u2063\u2064cockpit:editor:start";
@@ -9,6 +10,15 @@ export const EDITOR_END_SENTINEL = "\u2063\u2064\u2063\u2064cockpit:editor:end";
 
 export const DEFAULT_DOUBLE_ESCAPE_WINDOW_MS = 500;
 
+/** Cursor state when the user is typing rather than browsing history. */
+const NOT_BROWSING = -1;
+
+export interface CockpitEditorRouteTarget {
+  label: string;
+  sigil?: "@" | "#";
+  paint: (text: string) => string;
+}
+
 export interface CockpitClaudeEditorOptions {
 	/** Enable the double bare-Escape clear-input state machine. */
 	doubleEscapeClearInput: boolean;
@@ -22,6 +32,14 @@ export interface CockpitClaudeEditorOptions {
 	onError?: (error: unknown) => void;
 	/** Double-Escape window in ms (default 500). */
 	doubleEscapeWindowMs?: number;
+	/** Persistent prompt history, newest first. Read on every keystroke. */
+	getEntries?: () => readonly string[];
+	/** Called for every submitted prompt (including slash commands and `!` lines). */
+	record?: (text: string) => void;
+	/** Immutable route prefix painted inside the editor, never included in text. */
+	getRouteTarget?: () => CockpitEditorRouteTarget | undefined;
+	/** Called with the constructed editor so the host can push route updates. */
+	onEditor?: (editor: CockpitClaudeEditor) => void;
 }
 
 export interface DoubleEscapeDecision {
@@ -85,13 +103,18 @@ export class DoubleEscapeGate {
 }
 
 /**
- * Cockpit's CustomEditor: owns the double-Escape state machine and the editor
- * markers the fullscreen controller uses to split transcript / editor / chrome.
- * Installed at session start (reload-gated) via createCockpitClaudeEditorFactory.
+ * Cockpit's unified CustomEditor: owns the double-Escape state machine, the
+ * editor markers the fullscreen controller uses, the persistent ↑/↓ prompt
+ * history, and the input route-target prefix. Installed at session start
+ * (reload-gated) via createCockpitClaudeEditorFactory.
  */
 export class CockpitClaudeEditor extends CustomEditor {
 	private readonly editorOptions: CockpitClaudeEditorOptions;
 	private readonly doubleEscapeGate = new DoubleEscapeGate();
+	/** History browsing cursor: NOT_BROWSING while typing, else an index into getEntries(). */
+	private index = NOT_BROWSING;
+	/** What the user had typed before browsing started, restored on the way back down. */
+	private draft = "";
 
 	constructor(
 		tui: TUI,
@@ -102,17 +125,39 @@ export class CockpitClaudeEditor extends CustomEditor {
 		super(tui, theme, keybindings);
 		this.editorOptions = options;
 		if (options.doubleEscapeWindowMs !== undefined) this.doubleEscapeGate.windowMs = options.doubleEscapeWindowMs;
+		options.onEditor?.(this);
+	}
+
+	/** Submitted prompts go to the persistent store when enabled, else to the base in-memory history. */
+	override addToHistory(text: string): void {
+		if (this.editorOptions.record) this.editorOptions.record(text);
+		else super.addToHistory(text);
+	}
+
+	/** Programmatic writes (submit clears, `ui.setEditorText`) end history browsing. */
+	override setText(text: string): void {
+		this.index = NOT_BROWSING;
+		super.setText(text);
 	}
 
 	override render(width: number): string[] {
-		const lines = super.render(width);
-		if (!this.editorOptions.emitEditorMarkers) return lines;
-		return [EDITOR_START_SENTINEL, ...lines, EDITOR_END_SENTINEL];
+		const target = this.editorOptions.getRouteTarget?.();
+		const lines = target ? this.renderWithRouteTarget(width, target) : super.render(width);
+		const total = this.editorOptions.getEntries?.().length ?? 0;
+		const banner = this.browsing() && total > 0
+			? historyBanner(this.index + 1, total, width, this.getPaddingX(), this.borderColor)
+			: undefined;
+		if (!this.editorOptions.emitEditorMarkers) {
+			return banner ? [...lines, banner] : lines;
+		}
+		// The fullscreen controller treats everything between the sentinels as the
+		// editor region, so the banner must sit before the END marker to stay visible.
+		return [EDITOR_START_SENTINEL, ...lines, ...(banner ? [banner] : []), EDITOR_END_SENTINEL];
 	}
 
 	override handleInput(data: string): void {
-		const enabled = this.editorOptions.doubleEscapeClearInput;
 		if (this.isBareEscape(data)) {
+			const enabled = this.editorOptions.doubleEscapeClearInput;
 			if (enabled) {
 				const probe = readAutocompleteState(this);
 				const autocomplete: DoubleEscapeGateInput["autocomplete"] = probe.unknown
@@ -133,8 +178,30 @@ export class CockpitClaudeEditor extends CustomEditor {
 			super.handleInput(data);
 			return;
 		}
-		if (enabled) this.doubleEscapeGate.onAnyOtherInput();
+		if (this.editorOptions.doubleEscapeClearInput) this.doubleEscapeGate.onAnyOtherInput();
+		const keys = getKeybindings();
+		// History browsing only exists when persistent history is enabled; without
+		// getEntries, Up/Down keep their plain cursor-move meaning.
+		if (this.editorOptions.getEntries) {
+			if (keys.matches(data, "tui.editor.cursorUp") && this.canBrowseOlder()) {
+				this.step(1);
+				return;
+			}
+			if (keys.matches(data, "tui.editor.cursorDown") && this.canBrowseNewer()) {
+				this.step(-1);
+				return;
+			}
+		}
 		super.handleInput(data);
+		// Editing the recalled text means the user left history behind.
+		if (this.browsing() && this.getText() !== this.editorOptions.getEntries?.()[this.index]) {
+			this.index = NOT_BROWSING;
+		}
+	}
+
+	/** Repaint after a cross-extension input-target change. */
+	refreshRouteTarget(): void {
+		this.tui.requestRender();
 	}
 
 	private isBareEscape(data: string): boolean {
@@ -149,9 +216,90 @@ export class CockpitClaudeEditor extends CustomEditor {
 			this.editorOptions.onError?.(error);
 		}
 	}
+
+	private renderWithRouteTarget(width: number, target: CockpitEditorRouteTarget): string[] {
+		const paddingX = Math.min(this.getPaddingX(), Math.max(0, Math.floor((width - 1) / 2)));
+		const contentWidth = Math.max(1, width - paddingX * 2);
+		const layoutWidth = Math.max(1, contentWidth - (paddingX ? 0 : 1));
+		const token = truncateToWidth(`${target.sigil ?? "@"}${target.label}:`, Math.max(1, layoutWidth - 1), "…");
+		const injected = `${token}${visibleWidth(token) < layoutWidth ? " " : ""}`;
+
+		// Editor has no render-prefix API. Temporarily project the immutable target
+		// into its layout state so native wrapping and cursor placement stay correct,
+		// then restore the real editable state before returning.
+		const state = (this as unknown as EditorWithRenderState).state;
+		const originalLines = state.lines;
+		const originalCursorCol = state.cursorCol;
+		state.lines = [`${injected}${originalLines[0] ?? ""}`, ...originalLines.slice(1)];
+		if (state.cursorLine === 0) state.cursorCol += injected.length;
+		try {
+			const rendered = super.render(width);
+			const routeLine = rendered.findIndex((line) => line.includes(token));
+			if (routeLine >= 0) {
+				rendered[routeLine] = rendered[routeLine]!.replace(token, target.paint(token));
+			}
+			return rendered.map((line) => truncateToWidth(line, Math.max(1, width), ""));
+		} finally {
+			state.lines = originalLines;
+			state.cursorCol = originalCursorCol;
+		}
+	}
+
+	private browsing(): boolean {
+		return this.index > NOT_BROWSING;
+	}
+
+	/**
+	 * Mirrors the base editor's own gating: on the first line, and either already
+	 * browsing or with the cursor at the very start (which includes an empty editor) —
+	 * anywhere else Up is a plain cursor move.
+	 */
+	private canBrowseOlder(): boolean {
+		if (this.isShowingAutocomplete() || this.getCursor().line !== 0) return false;
+		return this.browsing() || this.getCursor().col === 0;
+	}
+
+	private canBrowseNewer(): boolean {
+		if (!this.browsing() || this.isShowingAutocomplete()) return false;
+		return this.getCursor().line === this.getLines().length - 1;
+	}
+
+	private step(delta: number): void {
+		const entries = this.editorOptions.getEntries?.() ?? [];
+		const next = this.index + delta;
+		if (next < NOT_BROWSING || next >= entries.length) return;
+		if (!this.browsing()) this.draft = this.getText();
+		// super.setText, so the index we are about to record survives.
+		super.setText(next === NOT_BROWSING ? this.draft : entries[next] ?? "");
+		this.index = next;
+	}
+}
+
+/** Compact history position label, indented to the editor's content. */
+export function historyBanner(
+	position: number,
+	total: number,
+	width: number,
+	paddingX: number,
+	paint: (value: string) => string,
+): string {
+	const indent = " ".repeat(Math.max(0, paddingX));
+	const inner = Math.max(1, width - indent.length * 2);
+	const label = tuiT("editor.historyBanner", { position, total });
+	return indent + paint(truncateToWidth(label, inner, "…"));
+}
+
+interface EditorRenderState {
+	lines: string[];
+	cursorLine: number;
+	cursorCol: number;
+}
+
+interface EditorWithRenderState {
+	state: EditorRenderState;
 }
 
-/** Build the editor factory Cockpit installs when a gated feature is on. */
+/** Build the editor factory Cockpit installs for its gated editor features. */
 export function createCockpitClaudeEditorFactory(options: CockpitClaudeEditorOptions) {
 	const factory = (tui: TUI, theme: EditorTheme, keybindings: KeybindingsManager) =>
 		new CockpitClaudeEditor(tui, theme, keybindings, options);

package/src/config.ts

@@ -1,7 +1,7 @@
 import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { getAgentDir } from "@earendil-works/pi-coding-agent";
-import { type CockpitConfig, type CurrencyMode, DEFAULT_CONFIG } from "./types.ts";
+import { type CockpitConfig, type CurrencyMode, DEFAULT_CONFIG, type StackStyle } from "./types.ts";
 
 const SIDEBAR_MIN_WIDTH = 32;
 const SIDEBAR_MAX_WIDTH = 56;
@@ -19,6 +19,7 @@ export function mergeConfig(base: CockpitConfig, over: unknown): CockpitConfig {
 	const isToolPaletteMode = (v: unknown): v is "classic" | "family" | "readwrite" | "search" | "mono" =>
 		v === "classic" || v === "family" || v === "readwrite" || v === "search" || v === "mono";
 	const isIconMode = (v: unknown): v is "auto" | "nerd" | "ascii" => v === "auto" || v === "nerd" || v === "ascii";
+	const isStackStyle = (v: unknown): v is StackStyle => v === "classic" || v === "zen";
 const isCurrencyMode = (v: unknown): v is CurrencyMode => v === "usd" || v === "cny";
 	const isSidebarMode = (v: unknown): v is "auto" | "on" | "off" => v === "auto" || v === "on" || v === "off";
 	const isSidebarDensity = (v: unknown): v is "comfortable" | "compact" => v === "comfortable" || v === "compact";
@@ -47,11 +48,13 @@ const isCurrencyMode = (v: unknown): v is CurrencyMode => v === "usd" || v === "
 		agentsMode: isMode(o.agentsMode) ? o.agentsMode : base.agentsMode,
 		todoMode: isMode(o.todoMode) ? o.todoMode : base.todoMode,
 		todoExpanded: typeof o.todoExpanded === "boolean" ? o.todoExpanded : base.todoExpanded,
+		stackStyle: isStackStyle(o.stackStyle) ? o.stackStyle : base.stackStyle,
 		hideNativeAgents: typeof o.hideNativeAgents === "boolean" ? o.hideNativeAgents : base.hideNativeAgents,
 		pinEditorBottom: typeof o.pinEditorBottom === "boolean" ? o.pinEditorBottom : base.pinEditorBottom,
 		doubleEscapeClearInput: typeof o.doubleEscapeClearInput === "boolean" ? o.doubleEscapeClearInput : base.doubleEscapeClearInput,
 		fullscreenInput: typeof o.fullscreenInput === "boolean" ? o.fullscreenInput : base.fullscreenInput,
 		copyOnSelect: typeof o.copyOnSelect === "boolean" ? o.copyOnSelect : base.copyOnSelect,
+		historyEnabled: typeof o.historyEnabled === "boolean" ? o.historyEnabled : base.historyEnabled,
 		currency: isCurrencyMode(o.currency) ? o.currency : base.currency,
 		currencyRate: typeof o.currencyRate === "number" && Number.isFinite(o.currencyRate) && o.currencyRate > 0
 			? Math.min(100, Math.max(0.01, Math.round(o.currencyRate * 100) / 100))
@@ -133,11 +136,13 @@ export function mergeConfigDocument(raw: unknown, config: CockpitConfig): Record
 		agentsMode: config.agentsMode,
 		todoMode: config.todoMode,
 		todoExpanded: config.todoExpanded,
+		stackStyle: config.stackStyle,
 		hideNativeAgents: config.hideNativeAgents,
 		pinEditorBottom: config.pinEditorBottom,
 		doubleEscapeClearInput: config.doubleEscapeClearInput,
 		fullscreenInput: config.fullscreenInput,
 		copyOnSelect: config.copyOnSelect,
+		historyEnabled: config.historyEnabled,
 		currency: config.currency,
 		currencyRate: config.currencyRate,
 		icons,