pi-ui-extend 0.1.8 → 0.1.11

package/README.md

@@ -14,6 +14,23 @@ The npm package is currently named `pi-ui-extend` and installs the `pix` CLI.
 - Pix extension UI helpers for toasts, menus, and rows above the input editor.
 - Bundled `pi-tools-suite` payload. On startup, Pix links it into Pi's standard user extension directory.
 
+## Why use Pix instead of bare Pi?
+
+Pix keeps the same Pi agent engine and SDK, but replaces the default terminal experience with a faster, more interactive coding cockpit:
+
+- **Tabs for real work.** Keep several workspace-scoped Pi sessions open in one terminal, switch between tasks instantly, and restore tab state after restart.
+- **A readable tool-call UI.** Tool output is grouped into clickable rows, so long reads, patches, shell logs, and errors can be collapsed or expanded instead of flooding the conversation.
+- **Local shell without leaving the chat.** Prefix a command with `!` to run it in an ephemeral in-chat shell block, or use `!!` for raw TTY programs.
+- **Voice prompts.** Dictate prompts locally in Russian or English with Vosk; no cloud speech service is required.
+- **Prompt drafting assistance.** Inline AI autocomplete suggests the next words while you type, and `/enhance` rewrites a rough draft into a clearer agent prompt.
+- **Workspace safety net.** Pix tracks supported file mutations and lets you roll back the latest workspace change with `/undo`.
+- **Clickable files and images.** File paths in the conversation become clickable links that open in Zed, including line and column when available; image labels can be opened in the system viewer.
+- **Session power tools.** Search across saved sessions, fork from an earlier message, clone the current branch, rename sessions, export/import JSONL, or share a private gist.
+- **Queued follow-ups.** Add the next prompt while the agent is still running; Pix sends it automatically when the current turn finishes.
+- **Live status panels.** Built-in panels surface todo state, async sub-agent activity, model/context usage, and compression stats above the editor.
+- **Renderer-aware extensions.** Pix extensions can draw rows above/below the input, show stackable toasts, open searchable popup menus, and react through an isolated event bus.
+- **Nicer terminal ergonomics.** Mouse scrolling, PageUp/PageDown scrollback, tab attention, status lines, terminal-output buffering, Nerd Font icons, and fallback icon mode are handled by the Pix renderer.
+
 ## Requirements
 
 - Node.js `>=22.19.0 <25` (`24.16.0` is pinned for development).
@@ -43,6 +60,12 @@ pix install --check
 
 `pix install` checks the icon font, `pi` CLI availability, and clipboard helpers. The `pix` launcher also prepends Pix's bundled dependency bin directory to `PATH`, so a package-manager install can use the bundled Pi CLI even when a separate global `pi` command is not present.
 
+After the setup check, review the user config files:
+
+- `~/.config/pi/pix.jsonc`: choose the voice-input language with `dictation.language` and keep only the `dictation.languages` models you want enabled.
+- `~/.config/pi/pi-tools-suite.jsonc`: enable/configure your LSP servers under `lsp.servers` and adjust pi-tools-suite modules or sub-agent presets if needed.
+- In Pix, run `/opencode-import` to import opencode accounts. For Antigravity OAuth accounts, run `/antigravity-import` or add another account with `/antigravity-add-account`.
+
 On startup, Pix ensures the bundled suite is available at:
 
 ```text
@@ -153,8 +176,6 @@ Useful environment variables:
 - `PIX_DISABLE_TERMINAL_OUTPUT_BUFFER=1` or `PIX_TERMINAL_OUTPUT_BUFFER=0`: disable Pix terminal output region buffering.
 - `PIX_USE_FALLBACK_ICONS=1` or `PIX_ICON_THEME=fallback`: use plain fallback icons when Nerd Font glyphs are unavailable.
 - `PIX_ICON_THEME=nerdFont`: force the Nerd Font icon theme.
-- `PIX_ANTIGRAVITY_GOOGLE_CLIENT_ID` / `ANTIGRAVITY_GOOGLE_CLIENT_ID`: Google OAuth client ID used for Antigravity quota/login integrations.
-- `PIX_ANTIGRAVITY_GOOGLE_CLIENT_SECRET` / `ANTIGRAVITY_GOOGLE_CLIENT_SECRET`: Google OAuth client secret used for Antigravity quota/login integrations.
 
 Pix user configuration is read from:
 
@@ -185,6 +206,40 @@ Example fallback icon configuration:
 - Click a tool row: expand or collapse that tool result.
 - Click the right-aligned microphone/language status widget: toggle voice input and switch Russian/English dictation.
 
+## Slash commands
+
+Type `/` in the prompt to open the command picker. Commands that accept arguments can also be called directly with inline arguments.
+
+| Command | Arguments | Description |
+|---|---|---|
+| `/settings` | — | Show current session, model, theme, and key settings. |
+| `/model` | `[provider/model[:thinking]]` | Select the active model. Without arguments, opens the model picker. With a reference like `anthropic/claude-sonnet-4-20250514:medium`, sets the model and optional thinking level directly. |
+| `/scoped-models` | `[refs…\|reset]` | Show or set the models used by the model selector and cycling. Pass one or more `provider/model[:thinking]` references separated by spaces or commas. Use `reset` to restore the default favorites. |
+| `/thinking` | `[level]` | Select the thinking level. Without arguments, opens the thinking picker. Accepts an explicit level (`off`, `minimal`, `low`, `medium`, `high`, `xhigh`). |
+| `/enhance` | — | Improve the current prompt draft using the prompt enhancer model. |
+| `/export` | `[path]` | Export the session. Defaults to HTML. Pass a `.jsonl` path to export as JSONL. |
+| `/import` | `<path.jsonl>` | Import and resume a session from a JSONL file. |
+| `/share` | — | Share the session as a private GitHub gist (requires `gh` CLI). |
+| `/copy` | — | Copy the last agent message to the clipboard. |
+| `/name` | `[name]` | Show or set the session display name. |
+| `/session` | — | Show session info: message counts, token usage, and cost. |
+| `/usage` | — | Show local account quota usage and context window utilization. |
+| `/changelog` | — | Show the Pi package changelog. |
+| `/update` | `[--force\|--help]` | Check for Pix package updates. `/update` is check-only; run `pix update` in a shell to install. |
+| `/hotkeys` | — | Show keyboard shortcuts. |
+| `/fork` | `[entry-id]` | Fork the session from the latest or specified user-message entry. |
+| `/clone` | — | Duplicate the current session at the current position. |
+| `/jump` | `[query]` | Jump to a previous user message. Opens the message picker, optionally filtered by query. |
+| `/search` | `<text>` | Search sessions for matching text and open a result in a new tab. |
+| `/reload` | — | Reload keybindings, extensions, skills, prompts, and themes from disk. |
+| `/resume` | `[path\|query]` | Resume a different session. Without arguments, opens the session picker. |
+| `/new` | — | Start a fresh session in the current tab. |
+| `/new_tab` | — | Open a fresh session in a new tab. |
+| `/compact` | `[instructions]` | Manually compact the session context, optionally with custom instructions for the compaction. |
+| `/quit`, `/exit` | — | Quit the renderer. |
+
+Extensions, prompt templates, and skills may register additional slash commands that appear in the command picker alongside the built-in ones.
+
 ## Voice input
 
 Pix can dictate into the prompt through local Vosk. The first start for each language downloads the small model into the gitignored `models/vosk/` directory inside this project:

package/bin/pix.mjs

@@ -9,8 +9,8 @@ const minimumNodeVersionLabel = "22.19.0";
 const launcherPath = fileURLToPath(import.meta.url);
 const packageRoot = dirname(dirname(launcherPath));
 const mainPath = fileURLToPath(new URL("../dist/main.js", import.meta.url));
-const updatePath = fileURLToPath(new URL("../dist/app/update.js", import.meta.url));
-const installPath = fileURLToPath(new URL("../dist/app/install.js", import.meta.url));
+const updatePath = fileURLToPath(new URL("../dist/app/cli/update.js", import.meta.url));
+const installPath = fileURLToPath(new URL("../dist/app/cli/install.js", import.meta.url));
 const distPath = dirname(mainPath);
 const rawArgs = process.argv.slice(2);
 const childArgs = [];
@@ -39,7 +39,7 @@ if (childArgs[0] === "update") {
 		console.error("pix update is not built yet. Run `npm run build:pix` or update from a published package.");
 		process.exit(1);
 	}
-	const { runPixUpdateCli } = await import(new URL("../dist/app/update.js", import.meta.url));
+	const { runPixUpdateCli } = await import(new URL("../dist/app/cli/update.js", import.meta.url));
 	process.exit(await runPixUpdateCli(childArgs.slice(1)));
 }
 
@@ -48,7 +48,7 @@ if (childArgs[0] === "install" || childArgs[0] === "setup") {
 		console.error("pix install is not built yet. Run `npm run build:pix` or update from a published package.");
 		process.exit(1);
 	}
-	const { runPixInstallCli } = await import(new URL("../dist/app/install.js", import.meta.url));
+	const { runPixInstallCli } = await import(new URL("../dist/app/cli/install.js", import.meta.url));
 	process.exit(await runPixInstallCli(childArgs.slice(1), { env: pixChildEnv() }));
 }
 

package/dist/app/app.d.ts

@@ -31,6 +31,7 @@ export declare class PiUiExtendApp {
     private readonly nerdFontController;
     private readonly popupActions;
     private readonly promptEnhancer;
+    private readonly autocompleteController;
     private readonly mouseController;
     private readonly popupMenus;
     private readonly voiceController;
@@ -48,6 +49,7 @@ export declare class PiUiExtendApp {
     private get input();
     private set input(value);
     private running;
+    private scheduledRenderTimer;
     private todoPanelExpanded;
     private subagentsPanelExpanded;
     private allThinkingExpanded;
@@ -85,6 +87,7 @@ export declare class PiUiExtendApp {
     private setSessionStatus;
     private setSessionActivity;
     private toolDefaultExpanded;
+    private toggleSuperCompactTools;
     private stopBlinking;
     private stop;
     private toggleTerminalBellSound;
@@ -92,6 +95,7 @@ export declare class PiUiExtendApp {
     private showToast;
     private clearToastTimers;
     private render;
+    private scheduleRender;
     private renderStatusLine;
     private terminalColumns;
     private terminalRows;

package/dist/app/app.js

@@ -1,51 +1,53 @@
 import { THEMES } from "../theme.js";
 import { InputEditor } from "../input-editor.js";
 import { compileOutputFilterPatterns, loadPixConfig, resolveToolRule, } from "../config.js";
-import { AppCommandController } from "./command-controller.js";
-import { ConversationViewport } from "./conversation-viewport.js";
-import { EditorLayoutRenderer } from "./editor-layout-renderer.js";
-import { AppExtensionActionsController } from "./extension-actions-controller.js";
-import { ExtensionUiController } from "./extension-ui-controller.js";
-import { AppInputActionController } from "./input-action-controller.js";
-import { AppInputController } from "./input-controller.js";
-import { AppBlinkController } from "./blink-controller.js";
+import { AppCommandController } from "./commands/command-controller.js";
+import { ConversationViewport } from "./rendering/conversation-viewport.js";
+import { EditorLayoutRenderer } from "./rendering/editor-layout-renderer.js";
+import { AppExtensionActionsController } from "./extensions/extension-actions-controller.js";
+import { ExtensionUiController } from "./extensions/extension-ui-controller.js";
+import { AppInputActionController } from "./input/input-action-controller.js";
+import { AppInputController } from "./input/input-controller.js";
+import { AppBlinkController } from "./screen/blink-controller.js";
 import { isRecord } from "./guards.js";
-import { AppMenuItemsController } from "./menu-items-controller.js";
-import { AppMouseController } from "./mouse-controller.js";
+import { AppMenuItemsController } from "./popup/menu-items-controller.js";
+import { AppMouseController } from "./screen/mouse-controller.js";
 import { createId } from "./id.js";
-import { NerdFontController } from "./nerd-font-controller.js";
-import { AppPopupActionController } from "./popup-action-controller.js";
-import { AppPopupMenuController } from "./popup-menu-controller.js";
-import { AppPromptEnhancerController } from "./prompt-enhancer-controller.js";
-import { AppQueuedMessageController } from "./queued-message-controller.js";
-import { AppRequestHistory } from "./request-history.js";
-import { AppRenderController } from "./render-controller.js";
+import { NerdFontController } from "./terminal/nerd-font-controller.js";
+import { AppPopupActionController } from "./popup/popup-action-controller.js";
+import { AppPopupMenuController } from "./popup/popup-menu-controller.js";
+import { AppPromptEnhancerController } from "./input/prompt-enhancer-controller.js";
+import { AppAutocompleteController } from "./input/autocomplete-controller.js";
+import { AppQueuedMessageController } from "./session/queued-message-controller.js";
+import { AppRequestHistory } from "./session/request-history.js";
+import { AppRenderController } from "./rendering/render-controller.js";
 import { createPixRuntime } from "./runtime.js";
-import { ScreenStyler } from "./screen-styler.js";
-import { AppScrollController } from "./scroll-controller.js";
-import { searchResultScrollNeedles, searchResultTargetEntry } from "./session-search.js";
-import { AppSessionLifecycleController } from "./session-lifecycle-controller.js";
-import { AppShellController } from "./shell-controller.js";
-import { runInteractiveShellCommand } from "./shell-command.js";
-import { AppSessionEventController } from "./session-event-controller.js";
-import { AppStatusController } from "./status-controller.js";
-import { StatusLineRenderer } from "./status-line-renderer.js";
-import { AppModelUsageController } from "./model-usage-controller.js";
-import { AppWorkspaceActionsController } from "./workspace-actions-controller.js";
-import { AppSubagentsWidgetController } from "./subagents-widget-controller.js";
-import { AppTodoWidgetController } from "./todo-widget-controller.js";
-import { AppTabsController } from "./tabs-controller.js";
-import { TabLineRenderer } from "./tab-line-renderer.js";
-import { AppTerminalController } from "./terminal-controller.js";
-import { TerminalBellSoundController } from "./terminal-bell-sound-controller.js";
-import { AppToastController } from "./toast-controller.js";
-import { checkPixUpdate, formatPixStartupUpdateDialog } from "./update.js";
-import { AppVoiceController } from "./voice-controller.js";
-import { createIsolatedExtensionEventBus } from "./extension-event-bus.js";
+import { ScreenStyler } from "./screen/screen-styler.js";
+import { AppScrollController } from "./screen/scroll-controller.js";
+import { searchResultScrollNeedles, searchResultTargetEntry } from "./session/session-search.js";
+import { AppSessionLifecycleController } from "./session/session-lifecycle-controller.js";
+import { AppShellController } from "./commands/shell-controller.js";
+import { runInteractiveShellCommand } from "./commands/shell-command.js";
+import { AppSessionEventController } from "./session/session-event-controller.js";
+import { AppStatusController } from "./screen/status-controller.js";
+import { StatusLineRenderer } from "./rendering/status-line-renderer.js";
+import { AppModelUsageController } from "./model/model-usage-controller.js";
+import { AppWorkspaceActionsController } from "./workspace/workspace-actions-controller.js";
+import { AppSubagentsWidgetController } from "./subagents/subagents-widget-controller.js";
+import { AppTodoWidgetController } from "./todo/todo-widget-controller.js";
+import { AppTabsController } from "./session/tabs-controller.js";
+import { TabLineRenderer } from "./rendering/tab-line-renderer.js";
+import { AppTerminalController } from "./terminal/terminal-controller.js";
+import { TerminalBellSoundController } from "./terminal/terminal-bell-sound-controller.js";
+import { AppToastController } from "./rendering/toast-controller.js";
+import { checkPixUpdate, formatPixStartupUpdateDialog } from "./cli/update.js";
+import { AppVoiceController } from "./input/voice-controller.js";
+import { createIsolatedExtensionEventBus } from "./extensions/extension-event-bus.js";
 import { setAppIconTheme } from "./icons.js";
 const TERMINAL_BELL_ATTENTION_EVENT = "pix:terminal-bell:attention";
 const SUBAGENTS_LIVE_STATE_EVENT = "pi-tools-suite:async-subagents:live-state";
 const TODO_STATE_EVENT = "pi-tools-suite:todo:state";
+const COALESCED_RENDER_DELAY_MS = 16;
 export class PiUiExtendApp {
     entries = [];
     options;
@@ -78,6 +80,7 @@ export class PiUiExtendApp {
     nerdFontController;
     popupActions;
     promptEnhancer;
+    autocompleteController;
     mouseController;
     popupMenus;
     voiceController;
@@ -111,6 +114,7 @@ export class PiUiExtendApp {
     get input() { return this.inputEditor.text; }
     set input(value) { this.inputEditor.setText(value); }
     running = false;
+    scheduledRenderTimer;
     todoPanelExpanded = true;
     subagentsPanelExpanded = true;
     allThinkingExpanded = false;
@@ -143,6 +147,7 @@ export class PiUiExtendApp {
             theme: this.theme,
             blinkController: this.blinkController,
             runtimeSession: () => this.runtime?.session,
+            render: () => this.scheduleRender(),
         });
         this.modelUsageController = new AppModelUsageController({
             runtimeSession: () => this.runtime?.session,
@@ -170,6 +175,8 @@ export class PiUiExtendApp {
             syncUserSessionEntryMetadata: () => this.workspaceActions.syncUserSessionEntryMetadata(),
             captureInputState: () => ({ text: this.inputEditor.text, cursor: this.inputEditor.cursor }),
             restoreInputState: (state) => this.restoreTabInputState(state.text, state.cursor),
+            captureDeferredUserMessages: () => this.queuedMessages.captureDeferredUserMessages(),
+            restoreDeferredUserMessages: (messages) => this.queuedMessages.restoreDeferredUserMessages(messages),
             addEntry: (entry) => this.addEntry(entry),
             showToast: (message, kind) => this.showToast(message, kind),
             render: () => this.render(),
@@ -191,6 +198,13 @@ export class PiUiExtendApp {
             toast: this.toastNotifier,
             render: () => this.render(),
         });
+        this.autocompleteController = new AppAutocompleteController({
+            runtime: () => this.runtime,
+            inputEditor: () => this.inputEditor,
+            autocompleteConfig: () => this.pixConfig.autocomplete,
+            isRunning: () => this.running,
+            render: () => this.render(),
+        });
         this.voiceController = new AppVoiceController({
             insertTranscript: (text) => this.insertVoiceTranscript(text),
             setPartialTranscript: (text) => this.setVoicePartialTranscript(text),
@@ -251,6 +265,7 @@ export class PiUiExtendApp {
             terminalBellSoundStatusWidgetEnabled: () => this.terminalBellSoundController.isEnabled(),
             voiceStatusWidgetText: () => this.voiceController.statusWidgetText(),
             voiceStatusWidgetActive: () => this.voiceController.statusWidgetActive(),
+            queueableInputActive: () => this.inputEditor.promptText.trimEnd().length > 0 || this.inputEditor.images.length > 0,
             userMessageJumpMenuActive: () => this.popupMenus.directMenu === "user-message-jump",
             allThinkingExpandedActive: () => this.allThinkingExpanded,
             superCompactToolsActive: () => this.superCompactTools,
@@ -291,12 +306,12 @@ export class PiUiExtendApp {
             cwd: this.options.cwd,
             sessionFile: () => this.runtime?.session.sessionFile,
             isRunning: () => this.running,
-            render: () => this.render(),
+            render: () => this.scheduleRender(),
         });
         this.todoWidgetController = new AppTodoWidgetController({
             sessionFile: () => this.runtime?.session.sessionFile,
             isRunning: () => this.running,
-            render: () => this.render(),
+            render: () => this.scheduleRender(),
         });
         this.workspaceActions = new AppWorkspaceActionsController({
             entries: this.entries,
@@ -320,13 +335,11 @@ export class PiUiExtendApp {
             conversationViewport: () => this.conversationViewport,
             isRunning: () => this.running,
             render: () => this.render(),
+            scheduleRender: () => this.scheduleRender(),
             setStatus: (status) => this.setStatus(status),
             restoreSessionStatus: () => this.restoreSessionStatus(),
             setSessionStatus: (session) => this.setSessionStatus(session),
             setSessionActivity: (activity) => this.setSessionActivity(activity),
-            flushDeferredUserMessages: () => {
-                void this.queuedMessages.flushDeferredUserMessages();
-            },
             updateQueuedMessageStatus: () => this.queuedMessages.updateQueuedMessageStatus(),
             prepareWorkspaceMutation: (toolName, args) => this.workspaceActions.prepareWorkspaceMutation(toolName, args),
             workspaceMutationFromToolExecution: (input) => this.workspaceActions.workspaceMutationFromToolExecution(input),
@@ -355,6 +368,7 @@ export class PiUiExtendApp {
             setInput: (value) => this.inputEditor.setText(value),
             insertInput: (value) => this.inputEditor.insert(value),
             attachImage: (data, mimeType) => this.inputEditor.attachImage(data, mimeType),
+            onDeferredUserMessagesChanged: () => this.tabsController.persistActiveDeferredUserMessages(),
         });
         this.editorLayoutRenderer = new EditorLayoutRenderer({
             theme: this.theme,
@@ -365,6 +379,7 @@ export class PiUiExtendApp {
             get subagentsPanelExpanded() { return app.subagentsPanelExpanded; },
             get subagentsWidgetState() { return app.subagentsWidgetController.widgetState; },
             get voicePartialText() { return app.voicePartialText; },
+            get autocompleteSuggestion() { return app.autocompleteController.suggestionText(); },
             renderExtensionInputComponent: (width) => this.extensionUiController.renderActiveCustomUi(width),
             extensionInputUsesEditor: () => this.extensionUiController.activeCustomUiUsesEditor(),
             widgetTuiHandle: () => this.extensionUiController.widgetTuiHandle(),
@@ -401,6 +416,11 @@ export class PiUiExtendApp {
             getInput: () => this.input,
             setInput: (value) => this.setInput(value),
             promptEnhancerModelRef: () => this.pixConfig.promptEnhancer.modelRef,
+            autocompleteModelRef: () => this.pixConfig.autocomplete.modelRef,
+            setAutocompleteModelRef: (modelRef) => {
+                this.pixConfig.autocomplete.modelRef = modelRef;
+                this.autocompleteController.dispose();
+            },
             enhancePrompt: () => this.promptEnhancer.enhancePrompt(),
             isRunning: () => this.running,
             stop: () => this.stop(),
@@ -414,6 +434,9 @@ export class PiUiExtendApp {
             modelRef: (model) => this.menuItems.modelRef(model),
             getFavoriteScopedModels: () => this.menuItems.getFavoriteScopedModels(),
             setSessionStatus: (session) => this.setSessionStatus(session),
+            queueUserMessage: (text) => {
+                this.queuedMessages.deferUserMessage(this.queuedMessages.createSubmittedUserMessage(text, text, []));
+            },
             resetSessionView: () => this.resetSessionView(),
             loadSessionHistory: () => this.loadSessionHistory(),
             afterSessionReplacement: (message) => this.afterSessionReplacement(message),
@@ -430,6 +453,7 @@ export class PiUiExtendApp {
                 this.popupMenus.setDirectQuery(query);
             },
             getResumeLoading: () => this.resumeLoading,
+            getResumeSessions: () => this.resumeSessions,
             setResumeLoading: (loading) => {
                 this.resumeLoading = loading;
             },
@@ -499,12 +523,20 @@ export class PiUiExtendApp {
             showToast: (message, kind, options) => this.showToast(message, kind, options),
             dismissToast: (toastId) => this.toastController.dismissToast(toastId),
             refreshModelUsageStatus: () => this.refreshModelUsageStatusFromClick(),
+            queueInputFromStatus: () => {
+                void this.inputActions.queueInputFromEditor().catch((error) => {
+                    this.addEntry({ id: createId("error"), kind: "error", text: `Queue input failed: ${error instanceof Error ? error.message : String(error)}` });
+                    this.showToast("Queue input failed", "error");
+                    this.setSessionStatus(this.runtime?.session);
+                    this.render();
+                });
+            },
             toggleAllThinkingExpanded: () => {
                 this.allThinkingExpanded = !this.allThinkingExpanded;
                 this.render();
             },
             toggleSuperCompactTools: () => {
-                this.superCompactTools = !this.superCompactTools;
+                this.toggleSuperCompactTools();
                 this.render();
             },
             toggleTerminalBellSound: () => this.toggleTerminalBellSound(),
@@ -543,6 +575,7 @@ export class PiUiExtendApp {
             setSessionActivity: (activity) => this.setSessionActivity(activity),
             restoreSessionStatus: () => this.restoreSessionStatus(),
             render: () => this.render(),
+            scheduleRender: () => this.scheduleRender(),
         });
         this.inputActions = new AppInputActionController({
             runtime: () => this.runtime,
@@ -587,6 +620,7 @@ export class PiUiExtendApp {
             handleDirectPopupInput: (char) => this.popupMenus.handleDirectPopupInput(char),
             autocompleteModel: () => this.popupMenus.autocompleteModel(),
             autocompleteThinking: () => this.popupMenus.autocompleteThinking(),
+            acceptAutocompleteSuggestion: () => this.autocompleteController.acceptSuggestion(),
             autocompleteSlashCommand: () => this.popupMenus.autocompleteSlashCommand(),
             toggleVoiceRecording: () => {
                 void this.voiceController.toggleRecording();
@@ -609,6 +643,7 @@ export class PiUiExtendApp {
             stopSubagentsPolling: () => this.subagentsWidgetController.stopPolling(),
             stopModelUsagePolling: () => this.modelUsageController.stopPolling(),
             stopVoiceInput: () => this.voiceController.dispose(),
+            stopAutocomplete: () => this.autocompleteController.dispose(),
             stopShellCommand: () => this.shellController.dispose(),
             unsubscribeSession: () => {
                 this.sessionLifecycle.unsubscribeSession();
@@ -660,6 +695,7 @@ export class PiUiExtendApp {
                 this.mouseController.statusThinkingTarget = undefined;
                 this.mouseController.statusContextTarget = undefined;
                 this.mouseController.statusModelUsageTarget = undefined;
+                this.mouseController.statusDraftQueueTarget = undefined;
                 this.mouseController.statusUserJumpTarget = undefined;
                 this.mouseController.statusThinkingExpandTarget = undefined;
                 this.mouseController.statusCompactToolsTarget = undefined;
@@ -672,6 +708,7 @@ export class PiUiExtendApp {
             },
             scrollReset: () => this.scrollController.reset(),
             loadSessionHistoryEntries: () => this.sessionEvents.loadSessionHistory(),
+            loadSessionHistoryEntriesAsync: (options) => this.sessionEvents.loadSessionHistoryAsync(options),
             syncUserSessionEntryMetadata: () => this.workspaceActions.syncUserSessionEntryMetadata(),
             restoreTabsAfterStartup: () => this.tabsController.restoreAfterStartup(),
             render: () => this.render(),
@@ -735,15 +772,18 @@ export class PiUiExtendApp {
             this.popupMenus.resetInputMenuDismissals();
         }
         this.input = value;
+        this.autocompleteController.dispose();
     }
     resetInputAfterProgrammaticEdit() {
         this.requestHistory.resetNavigation();
         this.popupMenus.resetInputMenuDismissals();
+        this.autocompleteController.dispose();
     }
     restoreTabInputState(text, cursor) {
         this.requestHistory.resetNavigation();
         this.popupMenus.resetInputMenuDismissals();
         this.inputEditor.setText(text, cursor);
+        this.autocompleteController.dispose();
     }
     async clearPersistedInputDraft() {
         await this.tabsController.setInputStateForTab(this.tabsController.activeInputTabId(), { text: "", cursor: 0 });
@@ -768,7 +808,7 @@ export class PiUiExtendApp {
         if (this.voicePartialText === text)
             return;
         this.voicePartialText = text;
-        this.render();
+        this.scheduleRender();
     }
     addVoiceSystemMessage(message) {
         this.addEntry({ id: createId("system"), kind: "system", text: message });
@@ -828,8 +868,21 @@ export class PiUiExtendApp {
         this.statusController.setSessionActivity(activity);
     }
     toolDefaultExpanded(toolName) {
+        if (this.superCompactTools)
+            return false;
         return resolveToolRule(toolName, this.pixConfig.toolRenderer).defaultExpanded === true;
     }
+    toggleSuperCompactTools() {
+        this.superCompactTools = !this.superCompactTools;
+        if (!this.superCompactTools)
+            return;
+        for (const entry of this.entries) {
+            if (entry.kind !== "tool" || !entry.expanded)
+                continue;
+            entry.expanded = false;
+            this.touchEntry(entry);
+        }
+    }
     stopBlinking() {
         this.blinkController.dispose();
     }
@@ -877,8 +930,22 @@ export class PiUiExtendApp {
         this.toastController.clearToastTimers();
     }
     render() {
+        if (this.scheduledRenderTimer) {
+            clearTimeout(this.scheduledRenderTimer);
+            this.scheduledRenderTimer = undefined;
+        }
+        this.autocompleteController.observeInput();
         this.renderController.render();
     }
+    scheduleRender() {
+        if (!this.running || this.scheduledRenderTimer)
+            return;
+        this.scheduledRenderTimer = setTimeout(() => {
+            this.scheduledRenderTimer = undefined;
+            this.renderController.render();
+        }, COALESCED_RENDER_DELAY_MS);
+        this.scheduledRenderTimer.unref?.();
+    }
     renderStatusLine() {
         this.renderController.renderStatusLine();
     }

package/dist/app/{cli.d.ts → cli/cli.d.ts}

@@ -1,4 +1,4 @@
-import type { AppOptions } from "./types.js";
+import type { AppOptions } from "../types.js";
 export type ResumeCommandOptions = {
     cwd: string;
     sessionPath: string;

package/dist/app/{cli.js → cli/cli.js}

@@ -1,5 +1,5 @@
 import { resolve } from "node:path";
-import { parseThemeName } from "../theme.js";
+import { parseThemeName } from "../../theme.js";
 export function usage() {
     return `Usage: pix [--cwd <path>] [--no-session] [--session <path>] [--theme dark|light] [--model <provider/model[:thinking]>]
 	       pix update [--check] [--force]

package/dist/app/{install.d.ts → cli/install.d.ts}

@@ -4,7 +4,9 @@ export type PixInstallCliOptions = {
 };
 export type PixInstallCliContext = {
     env?: NodeJS.ProcessEnv;
+    homeDir?: string;
 };
+export declare function formatPixInstallNextSteps(homeDir?: string): string;
 export declare function pixInstallUsage(): string;
 export declare function parsePixInstallArgs(argv: readonly string[]): PixInstallCliOptions;
 export declare function runPixInstallCli(argv?: readonly string[], context?: PixInstallCliContext): Promise<number>;

package/dist/app/{install.js → cli/install.js}

@@ -1,8 +1,22 @@
 import { spawn } from "node:child_process";
 import { existsSync } from "node:fs";
+import { homedir } from "node:os";
 import { join } from "node:path";
-import { FONT_FAMILY_NAME, installJetBrainsNerdFont, isJetBrainsNerdFontInstalled, } from "./nerd-font-controller.js";
-import { clipboardInstallHint, clipboardSupportAvailable } from "./clipboard.js";
+import { FONT_FAMILY_NAME, installJetBrainsNerdFont, isJetBrainsNerdFontInstalled, } from "../terminal/nerd-font-controller.js";
+import { clipboardInstallHint, clipboardSupportAvailable } from "../screen/clipboard.js";
+import { getPixConfigPath } from "../../config.js";
+export function formatPixInstallNextSteps(homeDir = homedir()) {
+    const pixConfigPath = getPixConfigPath(homeDir);
+    const toolsConfigPath = join(homeDir, ".config", "pi", "pi-tools-suite.jsonc");
+    return [
+        "",
+        "Next steps:",
+        `  1. Edit ${pixConfigPath} and set dictation.language / dictation.languages for voice input.`,
+        `  2. Edit ${toolsConfigPath} and enable the LSP servers you use under lsp.servers.`,
+        "  3. Start pix, then run /opencode-import to import opencode accounts.",
+        "     For Antigravity accounts, run /antigravity-import or /antigravity-add-account.",
+    ].join("\n");
+}
 export function pixInstallUsage() {
     return `Usage: pix install [--check]
        pix setup [--check]
@@ -86,7 +100,7 @@ export async function runPixInstallCli(argv = process.argv.slice(2), context = {
             failures += 1;
         }
     }
-    if (clipboardSupportAvailable(env)) {
+    if (await clipboardSupportAvailable(env)) {
         console.log("✓ Clipboard support is available");
     }
     else {
@@ -94,6 +108,7 @@ export async function runPixInstallCli(argv = process.argv.slice(2), context = {
         if (process.platform === "linux")
             failures += 1;
     }
+    console.log(formatPixInstallNextSteps(context.homeDir));
     return failures === 0 ? 0 : 1;
 }
 async function resolvePiCliStatus(env) {

package/dist/app/{command-controller.d.ts → commands/command-controller.d.ts}

@@ -1,5 +1,5 @@
 import type { CommandControllerHost } from "./command-host.js";
-import type { PopupMenuPlacement, SessionModel, SlashCommand, ThinkingLevel } from "./types.js";
+import type { PopupMenuPlacement, SessionModel, SlashCommand, ThinkingLevel } from "../types.js";
 export declare class AppCommandController {
     private readonly host;
     readonly slashCommands: readonly SlashCommand[];

package/dist/app/{command-controller.js → commands/command-controller.js}

@@ -28,13 +28,17 @@ export class AppCommandController {
         return {
             runSettingsCommand: () => this.modelActions.runSettingsCommand(),
             runModelSlashCommand: (argumentsText) => this.modelActions.runModelSlashCommand(argumentsText),
+            runDefaultModelSlashCommand: (argumentsText) => this.modelActions.runDefaultModelSlashCommand(argumentsText),
+            runAutocompleteSlashCommand: (argumentsText) => this.modelActions.runAutocompleteSlashCommand(argumentsText),
             runScopedModelsCommand: (argumentsText) => this.modelActions.runScopedModelsCommand(argumentsText),
             runThinkingSlashCommand: (argumentsText) => this.modelActions.runThinkingSlashCommand(argumentsText),
+            runDefaultThinkingSlashCommand: (argumentsText) => this.modelActions.runDefaultThinkingSlashCommand(argumentsText),
             runEnhanceCommand: () => this.host.enhancePrompt(),
             runExportCommand: (argumentsText) => this.sessionActions.runExportCommand(argumentsText),
             runImportCommand: (argumentsText) => this.sessionActions.runImportCommand(argumentsText),
             runShareCommand: () => this.sessionActions.runShareCommand(),
             runCopyCommand: () => this.sessionActions.runCopyCommand(),
+            runQueueCommand: (argumentsText) => this.sessionActions.runQueueCommand(argumentsText),
             runNameCommand: (argumentsText) => this.sessionActions.runNameCommand(argumentsText),
             runSessionInfoCommand: () => this.sessionActions.runSessionInfoCommand(),
             runUsageCommand: () => this.sessionActions.runUsageCommand(),

package/dist/app/{command-host.d.ts → commands/command-host.d.ts}

@@ -1,7 +1,7 @@
 import type { AgentSession, AgentSessionRuntime, SessionInfo } from "@earendil-works/pi-coding-agent";
-import type { SessionSearchResult } from "./session-search.js";
-import type { ActivePopupMenu, AppOptions, Entry, ModelMenuValue, PixMenuItem, PixMenuOptions, PopupMenuPlacement, ScopedSessionModel, SessionModel, ThinkingMenuValue } from "./types.js";
-import type { ToastNotifier } from "../ui.js";
+import type { SessionSearchResult } from "../session/session-search.js";
+import type { ActivePopupMenu, AppOptions, Entry, ModelMenuValue, PixMenuItem, PixMenuOptions, PopupMenuPlacement, ScopedSessionModel, SessionModel, ThinkingMenuValue } from "../types.js";
+import type { ToastNotifier } from "../../ui.js";
 export type DirectPopupMenu = Exclude<ActivePopupMenu, "slash">;
 export type CommandControllerHost = {
     readonly options: AppOptions;
@@ -9,6 +9,8 @@ export type CommandControllerHost = {
     getInput(): string;
     setInput(value: string): void;
     promptEnhancerModelRef(): string;
+    autocompleteModelRef(): string;
+    setAutocompleteModelRef(modelRef: string): void;
     enhancePrompt(): Promise<void>;
     isRunning(): boolean;
     stop(): void | Promise<void>;
@@ -22,6 +24,7 @@ export type CommandControllerHost = {
     modelRef(model: SessionModel): string;
     getFavoriteScopedModels(): ScopedSessionModel[];
     setSessionStatus(session: AgentSession | undefined): void;
+    queueUserMessage(text: string): void;
     resetSessionView(): void;
     loadSessionHistory(): void;
     afterSessionReplacement(message?: string): void;
@@ -35,6 +38,7 @@ export type CommandControllerHost = {
     getDirectPopupMenuQuery(): string;
     setDirectPopupMenuQuery(query: string): void;
     getResumeLoading(): boolean;
+    getResumeSessions(): readonly SessionInfo[];
     setResumeLoading(loading: boolean): void;
     setResumeSessions(sessions: SessionInfo[]): void;
     openResumeMenuWithQuery(query: string): void;