gloomberb 0.10.2 → 0.10.4

package/src/components/command-bar/surface/index.tsx

@@ -1,10 +1,15 @@
-import { useCallback } from "react";
+import { useCallback, useEffect, useMemo, useRef } from "react";
 import type { DataProvider } from "../../../types/data-provider";
 import type { AppTickerRepositoryPort } from "../../../core/app-service-ports";
 import type { PluginRegistry } from "../../../plugins/registry";
 import type { LayoutBounds } from "../../../plugins/pane-manager";
+import { usePlanAccess } from "../../../plugins/builtin/shared/plan-access";
+import { buildAssistCommandInventory } from "../assist/inventory";
+import { useCommandBarAssist } from "../assist/runtime";
+import { shouldAutoAskAssist, type AssistRowHandlers } from "../assist/model";
 import { useRouteListState } from "../routing/list-state";
 import { useCommandBarRootRuntime } from "../routes/root/runtime";
+import { parseRootShortcutIntent } from "../routes/root/shortcuts";
 import { useCommandBarThemePreview } from "../theme-preview";
 import { CommandBarPanel } from "../panel";
 import { useCommandBarNavigationState } from "../routing/navigation-state";
@@ -71,6 +76,7 @@ export function CommandBar({
     currentRouteRef,
     dismissCommandBar,
     lastMainBrowseRef,
+    markRootSelectionNavigated,
     popRoute,
     pushRoute,
     rootHoveredIdx,
@@ -78,6 +84,7 @@ export function CommandBar({
     rootModeKindRef,
     rootQuery,
     rootQueryRef,
+    rootSelectionNavigatedRef,
     rootSelectedIdx,
     setRootHoveredIdx,
     setRootQuery,
@@ -104,6 +111,7 @@ export function CommandBar({
     createPluginCommandItem,
     executeCollectionCommand,
     getAvailablePaneShortcutTemplates,
+    getAvailablePaneTemplates,
     getAvailablePluginCommands,
     ensureRouteFieldFocus,
     focusWorkflowField,
@@ -115,6 +123,7 @@ export function CommandBar({
     openInlineConfirm,
     openModeRoute,
     openPaneTemplateWorkflow,
+    openPluginCommandWorkflow,
     openWorkflowFieldPicker,
     paneShortcutItems,
     persistLayoutChange,
@@ -162,6 +171,82 @@ export function CommandBar({
   const getTickerSearchTickers = useCallback(() => stateRef.current.tickers, []);
   const hasPaneSettings = useCallback((paneId: string) => pluginRegistry.hasPaneSettings(paneId), [pluginRegistry]);
 
+  const rootShortcutIntent = useMemo(() => parseRootShortcutIntent({
+    query: rootQuery,
+    commands: availableCommands,
+    pluginCommands: getAvailablePluginCommands(),
+    paneTemplates: getAvailablePaneShortcutTemplates(rootQuery),
+    activeTicker: activeTickerSymbol,
+  }), [activeTickerSymbol, availableCommands, getAvailablePaneShortcutTemplates, getAvailablePluginCommands, rootQuery]);
+
+  const planAccess = usePlanAccess();
+  const buildAssistInventory = useCallback(() => buildAssistCommandInventory({
+    commands: availableCommands,
+    pluginCommands: getAvailablePluginCommands(),
+    paneTemplates: getAvailablePaneTemplates(undefined, { includePromptableTickerTemplates: true }),
+  }), [availableCommands, getAvailablePaneTemplates, getAvailablePluginCommands]);
+  // Only the root list asks on its own, and only for text the prefix parser
+  // could not claim — otherwise the user is mid-command, not mid-question.
+  const assistAutoAsk = !currentRoute
+    && planAccess.emailVerified
+    && shouldAutoAskAssist({ query: rootQuery, hasShortcutIntent: rootShortcutIntent.kind !== "none" });
+  const { assistActive, assistState, askAssist, resetAssist } = useCommandBarAssist({
+    autoAsk: assistAutoAsk,
+    getInventory: buildAssistInventory,
+    rootQuery,
+  });
+  // Filled in below once the selection runtime exists, so an AI candidate runs
+  // through the very same submit path as text the user typed.
+  const runRootQueryRef = useRef<
+    ((query: string, options?: { fallbackPrefix?: string }) => void) | null
+  >(null);
+  /**
+   * Query whose answer the user is already waiting on, set by activating the
+   * "Thinking…" row. The row leads the list and holds the default selection, so
+   * Enter has to mean something even before the answer is back: it claims the
+   * answer, and the best candidate runs the moment it lands.
+   */
+  const assistPendingRunRef = useRef<string | null>(null);
+  const askAssistNow = useCallback(() => {
+    assistPendingRunRef.current = rootQueryRef.current.trim();
+    askAssist();
+  }, [askAssist, rootQueryRef]);
+  useEffect(() => {
+    const pendingQuery = assistPendingRunRef.current;
+    if (!pendingQuery) return;
+    // Still the very ask that was claimed; nothing to do until it answers.
+    if (assistState.status === "loading" && assistState.query === pendingQuery) return;
+    assistPendingRunRef.current = null;
+    if (assistState.status !== "answered" || assistState.query !== pendingQuery) return;
+    // Typing moved on, so the answer is no longer what the user is looking at.
+    if (rootQueryRef.current.trim() !== pendingQuery) return;
+    const candidate = assistState.candidates[0];
+    if (!candidate) return;
+    runRootQueryRef.current?.(
+      candidate.input,
+      candidate.prefix ? { fallbackPrefix: candidate.prefix } : undefined,
+    );
+  }, [assistState, rootQueryRef]);
+  const startAssistSignUp = useCallback(() => {
+    const signUpCommand = getAvailablePluginCommands().find((command) => command.id === "auth-signup");
+    if (signUpCommand?.wizard?.length) {
+      openPluginCommandWorkflow(signUpCommand);
+      return;
+    }
+    setRootQuery("Sign Up");
+  }, [getAvailablePluginCommands, openPluginCommandWorkflow, setRootQuery]);
+  const assist = useMemo<AssistRowHandlers>(() => ({
+    enabled: planAccess.emailVerified,
+    auto: assistAutoAsk && assistActive,
+    state: assistState,
+    onAsk: askAssistNow,
+    onSignUp: startAssistSignUp,
+    onRunCandidate: (input: string, prefix?: string) => runRootQueryRef.current?.(
+      input,
+      prefix ? { fallbackPrefix: prefix } : undefined,
+    ),
+  }), [askAssistNow, assistActive, assistAutoAsk, assistState, planAccess.emailVerified, startAssistSignUp]);
+
   const {
     activeMatch,
     orderedRootResults,
@@ -176,6 +261,7 @@ export function CommandBar({
     activePortfolio,
     activeTickerData,
     activeTickerSymbol,
+    assist,
     availableCommands,
     buildLayoutItems,
     buildPaneSettingItems,
@@ -188,7 +274,6 @@ export function CommandBar({
     dataProvider,
     executeCollectionCommand,
     getAvailablePaneShortcutTemplates,
-    getAvailablePluginCommands,
     getTickers: getTickerSearchTickers,
     hasPaneSettings,
     localTickerSearchResultItems,
@@ -201,6 +286,8 @@ export function CommandBar({
     readTickerSearchCache,
     rootModeKind: rootModeInfo.kind,
     rootQuery,
+    rootSelectionNavigatedRef,
+    rootShortcutIntent,
     runDirectCommand,
     runSecurityDescriptionShortcut,
     setRootHoveredIdx,
@@ -217,6 +304,7 @@ export function CommandBar({
     acceptRootShortcutTab,
     acceptSelectedShortcutTab,
     activateListSelection,
+    runRootQuery,
     setActiveListQuery,
   } = useCommandBarSelectionRuntime({
     activeTickerSymbol,
@@ -251,6 +339,7 @@ export function CommandBar({
     updateWorkflowValue,
     visibleListStateRef,
   });
+  runRootQueryRef.current = runRootQuery;
 
   const routeListState = useRouteListState({
     activeMatch,
@@ -301,6 +390,7 @@ export function CommandBar({
     focusWorkflowField,
     getWorkflowInputRef,
     getWorkflowFieldStringValue,
+    markRootSelectionNavigated,
     moveWorkflowFocus,
     nativeListScrollRef,
     nativePaneChrome,
@@ -309,6 +399,7 @@ export function CommandBar({
     persistConfig,
     pluginRegistry,
     popRoute,
+    resetAssist,
     rootModeKind: rootModeInfo.kind,
     rootGhostSuffix,
     rootQueryLength: rootQuery.length,

package/src/components/command-bar/surface/portfolio.test.tsx

@@ -265,7 +265,8 @@ describe("CommandBar portfolio commands", () => {
 
     await testSetup.renderOnce();
     const frame = testSetup.captureCharFrame();
-    expect(frame).toContain('No matches for "Set Portfolio Position"');
+    // Nothing local matches, so the AI fallback row is all that is offered.
+    expect(frame).toContain("Ask AI");
     expect(frame).not.toContain("Create or update a manual position in a portfolio");
   });
 

package/src/components/command-bar/view-model.ts

@@ -28,6 +28,8 @@ export interface CommandBarItemView {
   right?: string;
   checked?: boolean;
   current?: boolean;
+  accent?: boolean;
+  disabled?: boolean;
 }
 
 export interface CommandBarRowPresentation {
@@ -36,6 +38,7 @@ export interface CommandBarRowPresentation {
   trailing: string;
   selected: boolean;
   primaryMuted: boolean;
+  trailingAccent: boolean;
 }
 
 export function resolveCommandBarMode(query: string, commandList?: Command[]): CommandBarModeInfo {
@@ -110,7 +113,7 @@ export function getEmptyState(mode: CommandBarMode, query: string, searchQuery?:
 
 export function getRowPresentation(item: CommandBarItemView, selected: boolean, showTrailing: boolean): CommandBarRowPresentation {
   const glyph = selected ? "\u203a" : " ";
-  const primaryMuted = item.kind === "plugin" && !item.checked;
+  const primaryMuted = (item.kind === "plugin" && !item.checked) || item.disabled === true;
   let trailing = "";
 
   if (showTrailing) {
@@ -125,6 +128,7 @@ export function getRowPresentation(item: CommandBarItemView, selected: boolean,
     trailing: t(trailing),
     selected,
     primaryMuted,
+    trailingAccent: item.accent === true && trailing.length > 0,
   };
 }
 
@@ -134,6 +138,8 @@ export function truncateText(text: string, width: number): string {
 
 function getCategoryPriority(category: string, sectionOrder: CommandBarSectionOrder = "default"): number {
   const normalized = category.trim().toLowerCase();
+  // The AI answers the question the user actually typed, so it leads the list.
+  if (normalized === "ask ai") return -100;
   if (normalized === "exact match") return -50;
   if (sectionOrder === "app-first") {
     if (normalized === "saved") return 100;

package/src/components/command-bar/workflow/broker.test.ts

@@ -0,0 +1,22 @@
+import { expect, test } from "bun:test";
+import type { BrokerAdapter } from "../../../types/broker";
+import { buildBrokerChoices } from "./broker";
+
+function createBroker(id: string, name: string): BrokerAdapter {
+  return {
+    id,
+    name,
+    configSchema: [{ key: "apiKey", label: "API key", type: "password", required: true }],
+    validate: async () => true,
+    importPositions: async () => [],
+  };
+}
+
+test("shows external brokers as sorted top-level choices", () => {
+  const choices = buildBrokerChoices(new Map([
+    ["ibkr", createBroker("ibkr", "Interactive Brokers")],
+    ["newbroker", createBroker("newbroker", "newbroker")],
+  ]));
+
+  expect(choices.map((choice) => choice.id)).toEqual(["ibkr", "newbroker"]);
+});

package/src/components/command-bar/workflow/broker.ts

@@ -23,6 +23,7 @@ export interface CommandBarBrokerChoice {
 export function buildBrokerChoices(brokers: ReadonlyMap<string, BrokerAdapter>): CommandBarBrokerChoice[] {
   return [...brokers.values()]
     .filter((adapter) => adapter.configSchema.length > 0)
+    .sort((a, b) => a.name.localeCompare(b.name))
     .map((adapter) => ({
       id: adapter.id,
       label: adapter.name,

package/src/components/index.ts

@@ -41,7 +41,7 @@ export { Checkbox } from "./ui/checkbox";
 export { ConfirmDialog } from "./ui/confirm-dialog";
 export { ChoiceDialog } from "./ui/choice-dialog";
 export type { ChoiceDialogChoice } from "./ui/choice-dialog";
-export type { DataTableCell, DataTableColumn } from "./ui/data-table";
+export type { DataTableCell, DataTableColumn, DataTableVisibleRange } from "./ui/data-table";
 export { EmptyState } from "./ui/status";
 export { getMessageComposerBlockHeight, MessageComposer } from "./ui/message-composer";
 export { NumberField, TextField } from "./ui/fields";

package/src/components/layout/detached-pane-shell.tsx

@@ -1,4 +1,4 @@
-import { Box, Text, useRendererHost, useUiCapabilities } from "../../ui";
+import { Box, Span, Text, useRendererHost, useUiCapabilities } from "../../ui";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { t } from "../../i18n";
 import { useShortcut, useViewport } from "../../react/input";
@@ -49,6 +49,7 @@ export function DetachedPaneShell({ pluginRegistry, desktopWindowBridge }: Detac
   const instance = useAppSelector((state) => findPaneInstance(state.config.layout, desktopWindowBridge.paneId) ?? null);
   const paneDef = instance ? pluginRegistry.panes.get(instance.paneId) ?? null : null;
   const hasPaneSettings = !!instance && pluginRegistry.hasPaneSettings(instance.instanceId);
+  const quickSettings = instance ? pluginRegistry.resolvePaneQuickSettings(instance.instanceId) : [];
   const titleState = useMemo(
     () => ({ config, paneState }) as Parameters<typeof getPaneDisplayTitle>[0],
     [config, paneState],
@@ -118,6 +119,16 @@ export function DetachedPaneShell({ pluginRegistry, desktopWindowBridge }: Detac
     stopMouse(event);
     pluginRegistry.openPaneSettingsFn(desktopWindowBridge.paneId);
   }, [desktopWindowBridge.paneId, pluginRegistry]);
+  const toggleQuickSetting = useCallback((key: string, event?: { stopPropagation?: () => void; preventDefault?: () => void }) => {
+    stopMouse(event);
+    focusPane();
+    void pluginRegistry.togglePaneQuickSetting(desktopWindowBridge.paneId, key).catch((error) => {
+      pluginRegistry.notify({
+        body: error instanceof Error ? error.message : "Could not update pane setting.",
+        type: "error",
+      });
+    });
+  }, [desktopWindowBridge.paneId, focusPane, pluginRegistry]);
 
   if (!instance || !paneDef) {
     return (
@@ -183,9 +194,36 @@ export function DetachedPaneShell({ pluginRegistry, desktopWindowBridge }: Detac
                 paddingRight={showWindowControls ? 0 : 1}
                 style={{ position: "relative" }}
               >
-                <Box flexGrow={1} minWidth={0} overflow="hidden">
+                <Box minWidth={0} flexShrink={1} overflow="hidden">
                   <Text fg={paneTitleText(focused, true, colors)} selectable={false} data-gloom-role="pane-title">{title}</Text>
                 </Box>
+                {quickSettings.map((setting) => (
+                  <Box
+                    key={setting.key}
+                    height={1}
+                    minWidth={20}
+                    paddingLeft={1}
+                    paddingRight={1}
+                    alignItems="center"
+                    justifyContent="center"
+                    className="electrobun-webkit-app-region-no-drag"
+                    data-gloom-role="pane-quick-setting"
+                    data-setting-key={setting.key}
+                    data-gloom-interactive="true"
+                    aria-label={`${setting.label}: ${setting.value ? "on" : "off"}`}
+                    aria-pressed={setting.value}
+                    title={`${setting.label}: ${setting.value ? "on" : "off"}`}
+                    style={{ cursor: "pointer" }}
+                    onMouseDown={(event: any) => toggleQuickSetting(setting.key, event)}
+                  >
+                    <Span style={{ display: "inline-flex", width: 12, height: 12, color: setting.value ? colors.warning : colors.textDim }}>
+                      <svg viewBox="0 0 12 12" width="12" height="12" fill="none" aria-hidden="true">
+                        <path d="M7.1 1.2 2.7 6.5h3.1l-.7 4.3 4.4-5.5H6.4l.7-4.1Z" fill="currentColor" />
+                      </svg>
+                    </Span>
+                  </Box>
+                ))}
+                <Box flexGrow={1} minWidth={0} />
                 {hasPaneSettings && (
                   <Text
                     fg={paneTitleText(focused, true, colors)}

package/src/components/layout/floating-pane.tsx

@@ -2,7 +2,7 @@ import { Box, Text, useUiCapabilities } from "../../ui";
 import type { ReactNode } from "react";
 import { colors, floatingPaneBg } from "../../theme/colors";
 import { PaneBodyFrame, getPaneWindowAttributes } from "./pane/frame";
-import { PaneHeader } from "./pane/header";
+import { PaneHeader, type PaneHeaderQuickSetting } from "./pane/header";
 import { hasPaneFooterContent, PaneFooterBar, type CombinedPaneFooter } from "./pane/footer";
 import { resolvePaneBodyFrame, shouldReservePaneFooter } from "./pane/sizing";
 
@@ -17,6 +17,7 @@ interface FloatingPaneWrapperProps {
   focused: boolean;
   windowModeSelected?: boolean;
   showActions?: boolean;
+  quickSettings?: PaneHeaderQuickSetting[];
   onMouseDown?: (event: any) => void;
   onMouseDownCapture?: (event: any) => void;
   onHeaderMouseMove?: (event: any) => void;
@@ -63,6 +64,7 @@ export function FloatingPaneWrapper({
   focused,
   windowModeSelected = false,
   showActions = false,
+  quickSettings,
   onMouseDown,
   onMouseDownCapture,
   onHeaderMouseMove,
@@ -115,6 +117,7 @@ export function FloatingPaneWrapper({
         windowModeSelected={windowModeSelected}
         floating
         showActions={showActions}
+        quickSettings={quickSettings}
         onHeaderMouseMove={onHeaderMouseMove}
         onHeaderMouseDown={onHeaderMouseDown}
         onHeaderMouseDrag={onHeaderMouseDrag}

package/src/components/layout/pane/header.tsx

@@ -15,6 +15,7 @@ interface PaneHeaderProps {
   windowModeSelected?: boolean;
   floating?: boolean;
   showActions?: boolean;
+  quickSettings?: PaneHeaderQuickSetting[];
   onHeaderMouseMove?: (event: any) => void;
   onHeaderMouseDown?: (event: any) => void;
   onHeaderMouseDrag?: (event: any) => void;
@@ -24,6 +25,15 @@ interface PaneHeaderProps {
   onCloseMouseDown?: (event: any) => void;
 }
 
+export interface PaneHeaderQuickSetting {
+  key: string;
+  icon: "zap";
+  label: string;
+  description?: string;
+  active: boolean;
+  onMouseDown?: (event: any) => void;
+}
+
 function truncateTitle(title: string, maxWidth: number): string {
   return truncateToDisplayWidth(title, maxWidth);
 }
@@ -43,9 +53,15 @@ function captureTerminalPointerDrag(renderer: unknown, renderable: unknown): voi
 function DesktopPaneButton({
   icon,
   onMouseDown,
+  color = colors.textDim,
+  label,
+  pressed,
 }: {
   icon: ReactNode;
   onMouseDown?: (event: any) => void;
+  color?: string;
+  label?: string;
+  pressed?: boolean;
 }) {
   return (
     <Box
@@ -54,6 +70,9 @@ function DesktopPaneButton({
       justifyContent="center"
       onMouseDown={onMouseDown}
       data-gloom-interactive={onMouseDown ? "true" : undefined}
+      aria-label={label}
+      aria-pressed={pressed}
+      title={label}
       style={{
         borderRadius: 4,
         minWidth: 20,
@@ -69,7 +88,7 @@ function DesktopPaneButton({
           justifyContent: "center",
           width: 12,
           height: 12,
-          color: colors.textDim,
+          color,
         }}
       >
         {icon}
@@ -92,7 +111,7 @@ function TerminalPaneButton({
   return (
     <Box
       height={1}
-      width={text.length}
+      width={displayWidth(text)}
       flexDirection="row"
       data-gloom-role={role}
       data-gloom-interactive={onMouseDown ? "true" : undefined}
@@ -110,6 +129,7 @@ export function PaneHeader({
   windowModeSelected = false,
   floating = false,
   showActions = false,
+  quickSettings = [],
   onHeaderMouseMove,
   onHeaderMouseDown,
   onHeaderMouseDrag,
@@ -125,6 +145,7 @@ export function PaneHeader({
   const backgroundColor = floating ? floatingPaneTitleBg(visuallyFocused) : paneTitleBg(visuallyFocused);
   const actionText = showActions ? PANE_HEADER_ACTION : "     ";
   const closeText = floating ? PANE_HEADER_CLOSE : "";
+  const terminalQuickSettingsWidth = quickSettings.reduce((total) => total + displayWidth(" ⚡ "), 0);
   const textColor = paneTitleText(visuallyFocused, floating);
   const handleTerminalHeaderMouseDown = useCallback((event: any) => {
     captureTerminalPointerDrag(nativeRenderer, terminalHeaderRef.current);
@@ -158,7 +179,7 @@ export function PaneHeader({
         <Text fg={visuallyFocused ? colors.borderFocused : colors.textMuted} selectable={false} data-gloom-role="pane-grip">
           {PANE_HEADER_GRIP}
         </Text>
-        <Box flexGrow={1} minWidth={0} overflow="hidden">
+        <Box minWidth={0} flexShrink={1} overflow="hidden">
           <Text
             fg={textColor}
             selectable={false}
@@ -173,6 +194,25 @@ export function PaneHeader({
             {title}
           </Text>
         </Box>
+        {quickSettings.map((setting) => (
+          <Box key={setting.key} data-gloom-role="pane-quick-setting" data-setting-key={setting.key}>
+            <DesktopPaneButton
+              onMouseDown={setting.onMouseDown}
+              color={setting.active ? colors.warning : colors.textDim}
+              label={`${setting.label}: ${setting.active ? "on" : "off"}`}
+              pressed={setting.active}
+              icon={(
+                <svg viewBox="0 0 12 12" width="12" height="12" fill="none" aria-hidden="true">
+                  <path
+                    d="M7.1 1.2 2.7 6.5h3.1l-.7 4.3 4.4-5.5H6.4l.7-4.1Z"
+                    fill="currentColor"
+                  />
+                </svg>
+              )}
+            />
+          </Box>
+        ))}
+        <Box flexGrow={1} minWidth={0} />
         <Box data-gloom-role="pane-action">
           {showActions ? (
             <DesktopPaneButton
@@ -213,10 +253,10 @@ export function PaneHeader({
     // Reserve 2 for corners, 1 for ─ after ┌, 1 for ─ before ┐
     const borderColor = visuallyFocused ? colors.borderFocused : colors.border;
     const innerWidth = Math.max(0, width - 4);
-    const contentWidth = PANE_HEADER_GRIP.length + closeText.length + actionText.length;
+    const contentWidth = PANE_HEADER_GRIP.length + terminalQuickSettingsWidth + closeText.length + actionText.length;
     const titleWidth = Math.max(0, innerWidth - contentWidth);
     const clippedTitle = truncateTitle(title, titleWidth);
-    const fillLen = Math.max(0, innerWidth - PANE_HEADER_GRIP.length - displayWidth(clippedTitle) - actionText.length - closeText.length);
+    const fillLen = Math.max(0, innerWidth - PANE_HEADER_GRIP.length - displayWidth(clippedTitle) - terminalQuickSettingsWidth - actionText.length - closeText.length);
     const fill = "─".repeat(fillLen);
 
     return (
@@ -233,6 +273,15 @@ export function PaneHeader({
       >
         <Text fg={borderColor} selectable={false}>{"┌─"}</Text>
         <Text fg={textColor} selectable={false}>{`${PANE_HEADER_GRIP}${clippedTitle}`}</Text>
+        {quickSettings.map((setting) => (
+          <TerminalPaneButton
+            key={setting.key}
+            text=" ⚡ "
+            fg={setting.active ? colors.warning : colors.textDim}
+            role="pane-quick-setting"
+            onMouseDown={setting.onMouseDown}
+          />
+        ))}
         <Text fg={borderColor} selectable={false}>{fill}</Text>
         <TerminalPaneButton
           text={actionText}
@@ -253,7 +302,7 @@ export function PaneHeader({
     );
   }
 
-  const titleWidth = Math.max(0, width - PANE_HEADER_GRIP.length - actionText.length - closeText.length);
+  const titleWidth = Math.max(0, width - PANE_HEADER_GRIP.length - terminalQuickSettingsWidth - actionText.length - closeText.length);
   const clippedTitle = truncateTitle(title, titleWidth);
   const padding = " ".repeat(Math.max(0, titleWidth - displayWidth(clippedTitle)));
 
@@ -272,6 +321,15 @@ export function PaneHeader({
       <Text fg={textColor} selectable={false}>
         {`${PANE_HEADER_GRIP}${clippedTitle}${padding}`}
       </Text>
+      {quickSettings.map((setting) => (
+        <TerminalPaneButton
+          key={setting.key}
+          text=" ⚡ "
+          fg={setting.active ? colors.warning : colors.textDim}
+          role="pane-quick-setting"
+          onMouseDown={setting.onMouseDown}
+        />
+      ))}
       <TerminalPaneButton
         text={actionText}
         fg={textColor}

package/src/components/layout/pane/index.tsx

@@ -2,7 +2,7 @@ import { Box, useUiCapabilities } from "../../../ui";
 import type { ReactNode } from "react";
 import { paneBg } from "../../../theme/colors";
 import { PaneBodyFrame, getPaneWindowAttributes } from "./frame";
-import { PaneHeader } from "./header";
+import { PaneHeader, type PaneHeaderQuickSetting } from "./header";
 import { hasPaneFooterContent, PaneFooterBar, type CombinedPaneFooter } from "./footer";
 import { resolvePaneBodyFrame, shouldReservePaneFooter } from "./sizing";
 
@@ -15,6 +15,7 @@ interface PaneWrapperProps {
   height?: number | `${number}%` | "auto";
   flexGrow?: number;
   showActions?: boolean;
+  quickSettings?: PaneHeaderQuickSetting[];
   onMouseDown?: (event: any) => void;
   onMouseDownCapture?: (event: any) => void;
   onHeaderMouseMove?: (event: any) => void;
@@ -36,6 +37,7 @@ export function PaneWrapper({
   height,
   flexGrow,
   showActions = false,
+  quickSettings,
   onMouseDown,
   onMouseDownCapture,
   onHeaderMouseMove,
@@ -87,6 +89,7 @@ export function PaneWrapper({
           focused={focused}
           windowModeSelected={windowModeSelected}
           showActions={showActions}
+          quickSettings={quickSettings}
           onHeaderMouseMove={onHeaderMouseMove}
           onHeaderMouseDown={onHeaderMouseDown}
           onHeaderMouseDrag={onHeaderMouseDrag}

package/src/components/layout/shell/index.tsx

@@ -30,6 +30,7 @@ import {
 } from "../../../state/selectors-ui";
 import { useThemeColors } from "../../../theme/theme-context";
 import { getPaneDisplayTitle } from "../pane/title";
+import type { PaneHeaderQuickSetting } from "../pane/header";
 import { getShortcutDisplayMode } from "../../../utils/shortcut-labels";
 import {
   actionMenuWidth,
@@ -423,6 +424,27 @@ export function Shell({
     (pane: ResolvedPane): string => getPaneDisplayTitle(titleState, pane.instance, pane.def),
     [titleState],
   );
+  const handlePaneQuickSetting = useCallback((paneId: string, key: string, event: any) => {
+    event?.preventDefault?.();
+    event?.stopPropagation?.();
+    focusPane(paneId);
+    void pluginRegistry.togglePaneQuickSetting(paneId, key).catch((error) => {
+      pluginRegistry.notify({
+        body: error instanceof Error ? error.message : "Could not update pane setting.",
+        type: "error",
+      });
+    });
+  }, [focusPane, pluginRegistry]);
+  const getPaneQuickSettings = useCallback((paneId: string): PaneHeaderQuickSetting[] => (
+    (pluginRegistry.resolvePaneQuickSettings?.(paneId) ?? []).map((setting) => ({
+      key: setting.key,
+      icon: setting.icon,
+      label: setting.label,
+      description: setting.description,
+      active: setting.value,
+      onMouseDown: (event) => handlePaneQuickSetting(paneId, setting.key, event),
+    }))
+  ), [config, handlePaneQuickSetting, pluginRegistry]);
 
   const openPaneMenu = useCallback((paneId: string, rect: LayoutBounds, event?: { preventDefault?: () => void; stopPropagation?: () => void }) => {
     const pane = paneMap.get(paneId);
@@ -561,6 +583,7 @@ export function Shell({
         dragFloatingRect={dragFloatingRect}
         focusedPaneId={focusedPaneId}
         getPaneTitle={getPaneTitle}
+        getPaneQuickSettings={getPaneQuickSettings}
         handleFloatingClose={handleFloatingClose}
         handleFloatingCloseMouseDown={handleFloatingCloseMouseDown}
         handleNativeDrag={handleNativeDrag}

package/src/components/layout/shell/pane/layers.tsx

@@ -12,6 +12,7 @@ import { pathKey } from "../../window-edit/mode";
 import { FloatingPaneWrapper } from "../../floating-pane";
 import { PaneContent } from "../../pane/content";
 import { PaneWrapper } from "../../pane";
+import type { PaneHeaderQuickSetting } from "../../pane/header";
 import { hasPaneFooterContent, PaneFooterProvider } from "../../pane/footer";
 import { resolvePaneBodyFrame, shouldReservePaneFooter } from "../../pane/sizing";
 import type { DividerPreviewState } from "../native/window-state";
@@ -31,6 +32,7 @@ interface ShellPaneLayersProps {
   dragFloatingRect: { paneId: string; rect: FloatingRect } | null;
   focusedPaneId: string | null;
   getPaneTitle: (pane: ResolvedPane) => string;
+  getPaneQuickSettings: (paneId: string) => PaneHeaderQuickSetting[];
   handleFloatingClose: (paneId: string) => void;
   handleFloatingCloseMouseDown: (paneId: string, event: any) => void;
   handleNativeDrag: ShellMouseHandler;
@@ -64,6 +66,7 @@ export function ShellPaneLayers({
   dragFloatingRect,
   focusedPaneId,
   getPaneTitle,
+  getPaneQuickSettings,
   handleFloatingClose,
   handleFloatingCloseMouseDown,
   handleNativeDrag,
@@ -129,6 +132,7 @@ export function ShellPaneLayers({
                     width={rect.width}
                     height={rect.height}
                     showActions={showActions}
+                    quickSettings={getPaneQuickSettings(leaf.instanceId)}
                     windowModeSelected={windowModeSelected}
                     footer={footer}
                     onMouseDownCapture={nativePaneChrome ? (event) => handleNativePaneMouseDown(leaf.instanceId, event) : undefined}
@@ -190,6 +194,7 @@ export function ShellPaneLayers({
                   focused={focused}
                   windowModeSelected={windowModeSelected}
                   showActions={showActions}
+                  quickSettings={getPaneQuickSettings(pane.instance.instanceId)}
                   footer={footer}
                   onMouseDownCapture={nativePaneChrome ? (event) => handleNativePaneMouseDown(pane.instance.instanceId, event) : undefined}
                   onHeaderMouseMove={() => setHoveredPaneIfChanged(pane.instance.instanceId)}