@firstpick/pi-package-webui 0.11.1 → 0.11.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/DEVELOPMENT.md +151 -12
- package/README.md +34 -6
- package/TECHNICAL.md +75 -8
- package/bin/pi-webui.mjs +5390 -11423
- package/index.ts +10 -3
- package/lib/component-update-state.mjs +2 -2
- package/lib/git-workflow-preference-values.mjs +122 -0
- package/lib/git-workflow-preferences.mjs +35 -563
- package/lib/package-updates.mjs +260 -0
- package/lib/rpc-supervisor-client.mjs +8 -4
- package/lib/server/app-runners.mjs +1667 -0
- package/lib/server/codex-fast-mode.mjs +161 -0
- package/lib/server/conversation-mode.mjs +218 -0
- package/lib/server/conversation-voice.mjs +318 -0
- package/lib/server/extension-ui-requests.mjs +114 -0
- package/lib/server/git-generation.mjs +459 -0
- package/lib/server/git-mutations.mjs +1827 -0
- package/lib/server/git-reads.mjs +608 -0
- package/lib/server/git-worktree-sessions.mjs +408 -0
- package/lib/server/helper-requests.mjs +82 -0
- package/lib/server/no-project-workspaces.mjs +103 -0
- package/lib/server/rpc-transports.mjs +394 -0
- package/lib/server/settings-store.mjs +544 -0
- package/lib/server/sse-delivery.mjs +138 -0
- package/lib/server/workspace-files.mjs +563 -0
- package/lib/update/supervisor.mjs +4 -0
- package/lib/webui-workspaces.mjs +2 -0
- package/package.json +4 -4
- package/public/activity-agents-controller.mjs +269 -0
- package/public/activity-events-controller.mjs +236 -0
- package/public/activity-intercom-controller.mjs +627 -0
- package/public/activity-queue-controller.mjs +534 -0
- package/public/activity-todo-view.mjs +89 -0
- package/public/activity-usage-controller.mjs +589 -0
- package/public/app.js +3761 -3886
- package/public/conversation-overview.css +84 -0
- package/public/conversation-overview.mjs +193 -0
- package/public/draft-conversations.mjs +135 -0
- package/public/focused-composer-controls.css +111 -0
- package/public/focused-composer-controls.mjs +143 -0
- package/public/focused-composer-disclosure.mjs +223 -0
- package/public/focused-shell-adapter.css +264 -0
- package/public/focused-shell-adapter.mjs +257 -0
- package/public/index.html +137 -80
- package/public/model-catalog-order.mjs +63 -0
- package/public/platform-event-stream.mjs +64 -0
- package/public/project-artifact-controller.mjs +218 -0
- package/public/project-file-viewer-controller.mjs +383 -0
- package/public/project-git-tools-controller.mjs +181 -0
- package/public/project-runners-controller.mjs +220 -0
- package/public/service-worker.js +52 -1
- package/public/session-attention-scheduler.mjs +182 -0
- package/public/session-composer-store.mjs +56 -0
- package/public/session-context.mjs +51 -0
- package/public/session-extension-requests.mjs +63 -0
- package/public/session-shelf-state.mjs +151 -0
- package/public/session-shelves.css +171 -0
- package/public/session-shelves.mjs +95 -0
- package/public/settings-navigation-controller.mjs +249 -0
- package/public/settings-navigation.css +61 -0
- package/public/settings-resource-controller.mjs +232 -0
- package/public/settings-workspace.css +19 -0
- package/public/settings-workspace.mjs +175 -0
- package/public/shell-actions.mjs +87 -0
- package/public/shell-attention-inbox.css +72 -0
- package/public/shell-attention-inbox.mjs +198 -0
- package/public/shell-context-actions.css +61 -0
- package/public/shell-context-actions.mjs +168 -0
- package/public/shell-inspector-resize.mjs +124 -0
- package/public/shell-navigation-resize.mjs +107 -0
- package/public/shell-navigation.mjs +127 -0
- package/public/shell-preferences.mjs +108 -0
- package/public/shell-surfaces.mjs +99 -0
- package/public/shell-tools-launcher.css +97 -0
- package/public/shell-tools-launcher.mjs +222 -0
- package/public/shell-view-host.mjs +115 -0
- package/public/shell-workspace.css +266 -0
- package/public/shell-workspace.mjs +402 -0
- package/public/sidebar-update-menu.css +190 -0
- package/public/sidebar-update-menu.mjs +512 -0
- package/public/styles.css +320 -169
- package/public/subagent-launch-slot-state.mjs +2 -2
- package/public/themed-selects.css +156 -0
- package/public/workspace-choices.mjs +104 -0
- package/tests/activity-agents-controller.test.mjs +652 -0
- package/tests/activity-events-controller.test.mjs +511 -0
- package/tests/app-runner-terminal-static.test.mjs +3 -3
- package/tests/append-system-http.test.mjs +7 -6
- package/tests/append-system-selector-static.test.mjs +6 -6
- package/tests/aur-review-widget-static.test.mjs +11 -3
- package/tests/boot-failure-diagnostics.test.mjs +8 -3
- package/tests/browser/activity-intercom-controller.spec.mjs +457 -0
- package/tests/browser/activity-navigation-integration.spec.mjs +45 -0
- package/tests/browser/activity-owner-integration.spec.mjs +201 -0
- package/tests/browser/activity-queue-controller.spec.mjs +405 -0
- package/tests/browser/activity-section-picker.spec.mjs +294 -0
- package/tests/browser/activity-todo-view.spec.mjs +60 -0
- package/tests/browser/activity-usage-controller.spec.mjs +416 -0
- package/tests/browser/compact-layout-integration.spec.mjs +58 -0
- package/tests/browser/composer-action-grid-reorder.spec.mjs +16 -0
- package/tests/browser/composer-disclosure.spec.mjs +389 -0
- package/tests/browser/composer-toolbar-polish.spec.mjs +343 -0
- package/tests/browser/control-deck-component-updates.spec.mjs +5 -14
- package/tests/browser/control-deck-side-panels.spec.mjs +27 -12
- package/tests/browser/control-visibility.spec.mjs +5 -0
- package/tests/browser/controls-layout.spec.mjs +21 -2
- package/tests/browser/conversation-overview.spec.mjs +251 -0
- package/tests/browser/draft-conversations.spec.mjs +276 -0
- package/tests/browser/empty-startup-fixture.mjs +135 -0
- package/tests/browser/empty-startup.spec.mjs +282 -0
- package/tests/browser/events-tree-context-menu.spec.mjs +1 -0
- package/tests/browser/focused-composer-more.spec.mjs +127 -0
- package/tests/browser/focused-model-shortcuts.spec.mjs +120 -0
- package/tests/browser/focused-navigation-fixture.mjs +32 -0
- package/tests/browser/focused-project-activity.spec.mjs +111 -0
- package/tests/browser/focused-shell-integration.spec.mjs +208 -0
- package/tests/browser/folder-picker-layout-fixture.mjs +13 -0
- package/tests/browser/folder-picker-layout.spec.mjs +302 -0
- package/tests/browser/footer-model-advanced-layout.spec.mjs +27 -14
- package/tests/browser/git-setup-cancel.spec.mjs +251 -0
- package/tests/browser/guided-git-fallback.spec.mjs +40 -21
- package/tests/browser/inspector-header.spec.mjs +221 -0
- package/tests/browser/inspector-overview-integration.spec.mjs +104 -0
- package/tests/browser/inspector-resize.spec.mjs +227 -0
- package/tests/browser/inspector-topic-overflow.spec.mjs +56 -0
- package/tests/browser/interaction-action-discovery.spec.mjs +332 -0
- package/tests/browser/interaction-attention-inbox.spec.mjs +364 -0
- package/tests/browser/interaction-attention-integration.spec.mjs +53 -0
- package/tests/browser/interaction-composer-controls.spec.mjs +267 -0
- package/tests/browser/interaction-composer-integration.spec.mjs +175 -0
- package/tests/browser/interaction-continuity.spec.mjs +50 -26
- package/tests/browser/interaction-model-picker.spec.mjs +86 -0
- package/tests/browser/last-terminal-close.spec.mjs +280 -0
- package/tests/browser/mobile-foundation.spec.mjs +172 -20
- package/tests/browser/model-catalog-groups.spec.mjs +104 -0
- package/tests/browser/more-row-menus.spec.mjs +258 -0
- package/tests/browser/new-tab-hit-target.spec.mjs +228 -0
- package/tests/browser/no-project-conversation.spec.mjs +113 -0
- package/tests/browser/optimistic-prompt.spec.mjs +3 -0
- package/tests/browser/overhaul-w7-accessibility.spec.mjs +227 -0
- package/tests/browser/overhaul-w7-capabilities.spec.mjs +298 -0
- package/tests/browser/overhaul-w7-companions.spec.mjs +290 -0
- package/tests/browser/overhaul-w7-focus-repairs.spec.mjs +210 -0
- package/tests/browser/overhaul-w7-layout-repairs.spec.mjs +183 -0
- package/tests/browser/overhaul-w7-parent-repairs.spec.mjs +97 -0
- package/tests/browser/overhaul-w7-pwa.spec.mjs +247 -0
- package/tests/browser/overhaul-w7-responsive.spec.mjs +450 -0
- package/tests/browser/overhaul-w7-update.spec.mjs +215 -0
- package/tests/browser/overhaul-w7-zoom.spec.mjs +243 -0
- package/tests/browser/overview-agent-ownership.spec.mjs +45 -0
- package/tests/browser/persistent-ui-layout.spec.mjs +3 -0
- package/tests/browser/project-artifact-controller.spec.mjs +324 -0
- package/tests/browser/project-artifact-integration.spec.mjs +103 -0
- package/tests/browser/project-file-buffer-integration.spec.mjs +230 -0
- package/tests/browser/project-git-tools-integration.spec.mjs +369 -0
- package/tests/browser/session-fixture.mjs +118 -0
- package/tests/browser/session-ownership.spec.mjs +175 -0
- package/tests/browser/session-shelves-integration.spec.mjs +219 -0
- package/tests/browser/session-shelves.spec.mjs +340 -0
- package/tests/browser/session-sidebar-resize.spec.mjs +138 -0
- package/tests/browser/session-summary.spec.mjs +17 -12
- package/tests/browser/settings-complete-home.spec.mjs +463 -0
- package/tests/browser/settings-entrypoint.spec.mjs +104 -0
- package/tests/browser/settings-navigation-controller.spec.mjs +383 -0
- package/tests/browser/settings-navigation-integration.spec.mjs +348 -0
- package/tests/browser/settings-resource-lifetime.spec.mjs +349 -0
- package/tests/browser/settings-workspace-integration.spec.mjs +132 -0
- package/tests/browser/shell-ownership.spec.mjs +398 -0
- package/tests/browser/shell-rollout-fixture.mjs +259 -0
- package/tests/browser/shell-rollout.spec.mjs +357 -0
- package/tests/browser/shell-tools-launcher.spec.mjs +260 -0
- package/tests/browser/shell-workspace.spec.mjs +433 -0
- package/tests/browser/side-panel-section-reorder.spec.mjs +3 -1
- package/tests/browser/sidebar-floating-tooltips.spec.mjs +37 -0
- package/tests/browser/sidebar-update-integration.spec.mjs +277 -0
- package/tests/browser/sidebar-update-menu.spec.mjs +402 -0
- package/tests/browser/sidebar-update-progress.spec.mjs +472 -0
- package/tests/browser/stream-output-isolation.spec.mjs +6 -3
- package/tests/browser/themed-selects.spec.mjs +297 -0
- package/tests/browser/thread-start-flow.spec.mjs +481 -0
- package/tests/browser/ui-polish-activity-controls.spec.mjs +177 -0
- package/tests/browser/ui-polish-features.spec.mjs +85 -0
- package/tests/browser/ui-polish-file-header.spec.mjs +43 -0
- package/tests/browser/ui-polish-local-git.spec.mjs +183 -0
- package/tests/browser/ui-polish-mobile-recovery.spec.mjs +36 -0
- package/tests/browser/ui-polish-navigation.spec.mjs +127 -0
- package/tests/browser/ui-polish-session-actions.spec.mjs +282 -0
- package/tests/browser/user-noticeable-fixes.spec.mjs +10 -3
- package/tests/browser/windows-drive-parent.spec.mjs +4 -2
- package/tests/browser/workspace-draft-selection.spec.mjs +266 -0
- package/tests/codex-fast-mode-static.test.mjs +16 -11
- package/tests/codex-speed-mode-browser-state.test.mjs +6 -3
- package/tests/codex-usage-source.test.mjs +4 -3
- package/tests/component-update-api-static.test.mjs +2 -2
- package/tests/composer-action-grid-reorder-static.test.mjs +3 -3
- package/tests/control-deck-component-updates-static.test.mjs +9 -4
- package/tests/control-visibility-static.test.mjs +3 -3
- package/tests/controls-layout-static.test.mjs +5 -5
- package/tests/conversation-overview-adapter.test.mjs +100 -0
- package/tests/document-artifact-static.test.mjs +2 -1
- package/tests/draft-conversations.test.mjs +205 -0
- package/tests/empty-startup-launcher.test.mjs +197 -0
- package/tests/events-tree-context-menu-static.test.mjs +22 -18
- package/tests/fake-pi-session-ownership.test.mjs +302 -0
- package/tests/fast-mode-client-static.test.mjs +1 -1
- package/tests/feature-decision-output-popup-static.test.mjs +2 -2
- package/tests/feature-system-prompt-optional-feature-static.test.mjs +1 -1
- package/tests/file-viewer-image-static.test.mjs +15 -11
- package/tests/file-viewer-search-static.test.mjs +5 -5
- package/tests/fixtures/fake-pi.mjs +41 -9
- package/tests/footer-provider-usage-visual-static.test.mjs +7 -6
- package/tests/foreground-transcript-catch-up-static.test.mjs +7 -4
- package/tests/git-footer-context-menu-static.test.mjs +1 -1
- package/tests/git-panel-file-preview-static.test.mjs +41 -48
- package/tests/git-panel-live-updates-static.test.mjs +2 -1
- package/tests/git-workflow-dispatch.test.mjs +66 -0
- package/tests/git-workflow-preferences.test.mjs +9 -1
- package/tests/guided-git-activation-static.test.mjs +14 -11
- package/tests/guided-git-fallback-ui-static.test.mjs +8 -5
- package/tests/guided-git-message-reliability-static.test.mjs +10 -6
- package/tests/guided-git-publication-backend-static.test.mjs +16 -11
- package/tests/http-endpoints-harness.test.mjs +21 -9
- package/tests/interaction-state-stability-static.test.mjs +4 -3
- package/tests/intercom-conversation-viewer-static.test.mjs +29 -17
- package/tests/intercom-tag-layout-static.test.mjs +13 -12
- package/tests/intercom-tag-overflow-layout.test.mjs +11 -10
- package/tests/main-output-loading-static.test.mjs +4 -4
- package/tests/middle-button-drag-scroll-static.test.mjs +3 -3
- package/tests/mobile-compact-layout.test.mjs +2 -2
- package/tests/mobile-continuity-tablet-static.test.mjs +3 -3
- package/tests/mobile-foundation-static.test.mjs +10 -7
- package/tests/mobile-phone-experience-static.test.mjs +3 -2
- package/tests/mobile-static.test.mjs +173 -135
- package/tests/model-catalog-order.test.mjs +103 -0
- package/tests/native-parity.test.mjs +6 -4
- package/tests/native-session-choice-owner.test.mjs +102 -0
- package/tests/native-update-lifecycle.test.mjs +10 -5
- package/tests/no-project-http-harness.test.mjs +328 -0
- package/tests/no-project-navigation.test.mjs +54 -0
- package/tests/no-project-workspaces.test.mjs +77 -0
- package/tests/open-issue-wizard-static.test.mjs +1 -1
- package/tests/optional-feature-migration-frontend.test.mjs +4 -4
- package/tests/optional-feature-prompt-impact-static.test.mjs +3 -3
- package/tests/package-updates.test.mjs +630 -0
- package/tests/persistent-ui-layout-static.test.mjs +3 -3
- package/tests/platform-event-stream.test.mjs +253 -0
- package/tests/project-file-viewer-controller.test.mjs +652 -0
- package/tests/project-git-tools-adapter.test.mjs +103 -0
- package/tests/project-git-tools-controller.test.mjs +577 -0
- package/tests/project-runners-controller.test.mjs +453 -0
- package/tests/prompt-input-vertical-scroll-static.test.mjs +3 -3
- package/tests/prompt-routing-input-clear-static.test.mjs +2 -2
- package/tests/questionnaire-dialog.test.mjs +6 -6
- package/tests/queue-edit-reorder-static.test.mjs +48 -51
- package/tests/rpc-supervisor-host.test.mjs +4 -1
- package/tests/safety-guard-auto-review-static.test.mjs +1 -1
- package/tests/sampling-native-controls-user-flow.test.mjs +7 -1
- package/tests/server-app-runners.test.mjs +536 -0
- package/tests/server-codex-fast-mode.test.mjs +346 -0
- package/tests/server-conversation-mode.test.mjs +386 -0
- package/tests/server-conversation-voice.test.mjs +426 -0
- package/tests/server-extension-ui-requests.test.mjs +357 -0
- package/tests/server-git-generation.test.mjs +558 -0
- package/tests/server-git-mutations.test.mjs +729 -0
- package/tests/server-git-reads.test.mjs +381 -0
- package/tests/server-git-worktree-sessions.test.mjs +502 -0
- package/tests/server-helper-requests.test.mjs +364 -0
- package/tests/server-rpc-transports.test.mjs +553 -0
- package/tests/server-settings-store.test.mjs +132 -0
- package/tests/server-shell-rollout.test.mjs +478 -0
- package/tests/server-sse-delivery.test.mjs +410 -0
- package/tests/server-workspace-files.test.mjs +546 -0
- package/tests/session-attention-scheduler.test.mjs +514 -0
- package/tests/session-composer-store.test.mjs +153 -0
- package/tests/session-context.test.mjs +134 -0
- package/tests/session-extension-requests.test.mjs +193 -0
- package/tests/session-ownership-adapter.test.mjs +130 -0
- package/tests/session-sampling-ui-static.test.mjs +10 -4
- package/tests/session-send-lifetime.test.mjs +140 -0
- package/tests/session-shelf-state.test.mjs +348 -0
- package/tests/session-shelves-adapter.test.mjs +79 -0
- package/tests/session-summary-lifetime.test.mjs +54 -0
- package/tests/settings-resource-controller.test.mjs +548 -0
- package/tests/shell-action-adapter.test.mjs +169 -0
- package/tests/shell-actions.test.mjs +182 -0
- package/tests/shell-navigation.test.mjs +348 -0
- package/tests/shell-preferences.test.mjs +367 -0
- package/tests/side-panel-section-height-removal-static.test.mjs +3 -3
- package/tests/stream-output-isolation-static.test.mjs +1 -1
- package/tests/subagent-gate-visibility.test.mjs +1 -1
- package/tests/subagent-launch-slot-state.test.mjs +2 -2
- package/tests/subagent-launch-slots-static.test.mjs +1 -1
- package/tests/subagent-observability-static.test.mjs +2 -2
- package/tests/subagent-reliability-integration.test.mjs +13 -30
- package/tests/syntax-highlighting-static.test.mjs +3 -3
- package/tests/tab-close-continuity-static.test.mjs +1 -1
- package/tests/tab-metadata-ordering.test.mjs +99 -0
- package/tests/terminal-cwd-grouping-static.test.mjs +2 -2
- package/tests/terminal-tab-prompt-tooltip-static.test.mjs +2 -0
- package/tests/terminal-tab-workspace-static.test.mjs +5 -4
- package/tests/terminal-tabs-resize-static.test.mjs +1 -1
- package/tests/theme-customizer-static.test.mjs +1 -1
- package/tests/thread-display-title.test.mjs +44 -0
- package/tests/update-api-harness.test.mjs +15 -14
- package/tests/update-tab-restore-harness.test.mjs +3 -0
- package/tests/webui-settings-locking.test.mjs +2 -2
- package/tests/windows-drive-cwd-picker-static.test.mjs +7 -9
- package/tests/workspace-choices.test.mjs +114 -0
- package/tests/workspace-save-load-static.test.mjs +7 -4
package/TECHNICAL.md
CHANGED
|
@@ -4,12 +4,66 @@ Advanced user setup, configuration, compatibility, security, and troubleshooting
|
|
|
4
4
|
|
|
5
5
|
[Back to the human-friendly README](README.md) · [Contributor and implementation guide](DEVELOPMENT.md)
|
|
6
6
|
|
|
7
|
+
## Workspace selection before the first prompt
|
|
8
|
+
|
|
9
|
+
On an empty conversation, Open workspace selects a folder without starting Pi. The first nonempty prompt creates the session in that folder. Leaving typed text saves a browser Draft with its selected folder, including across reloads. A blank folder selection stays in the current page only until you type or send. Pinned folders and folder creation work before any terminal exists. Existing-session, split and restore actions keep their current behavior.
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
## Starting threads
|
|
13
|
+
|
|
14
|
+
The sidebar **New thread** button opens a folder palette built by `public/workspace-choices.mjs`: Current folder, No project, pinned folders, recent thread folders (deduplicated, at most 12), then Browse… and Branch worktree…. Folder and No project choices only open or reuse a blank client draft with that cwd. On a draft's empty screen, the Workspace value opens the same list as a dropdown and changes only that draft's cwd; No project clears it. Neither path calls `POST /api/tabs`; the first nonempty prompt creates exactly one thread. Branch worktree keeps creating its thread immediately.
|
|
15
|
+
|
|
16
|
+
Visible text calls Pi conversations threads. Code, element IDs, `/api/tabs` and storage keys still say tab. New threads default to `Thread N`, and stored `Terminal N` titles display as `Thread N` without being rewritten.
|
|
17
|
+
## Compact desktop preview
|
|
18
|
+
|
|
19
|
+
Fresh installations default to the compact layout only when the server can establish that no earlier Web UI state exists. Existing installations keep Classic; choose **Controls → Interface → Desktop layout → Compact preview** to switch. Its session navigation can sit on the left or above the conversation. **All tools** supports up to twenty pins, saved with the layout choice in this browser. Settings and inspectors reuse your existing controls and their original scopes. Settings groups Appearance, Models and resources, Features, Accounts, Voice, Connection, System, and Help. Search shows each result’s scope and why a control is unavailable. A result opens its category and original control; browser Back and Forward restore the destination. Search does not apply settings. A Settings gear beside the bottom-left workspace buttons opens this same page. Models and resources includes Sampling, Codex speed and Summary Setup; Appearance includes Git-footer Visibility and saved tool-output expansion; System includes project runner configuration. These controls retain their session, browser, global or project scope as shown. Runtime settings and Features Setup remain the home for their existing preferences. **All tools → Model shortcuts** opens the scoped model picker; **Use advanced model shortcuts** or **Use simple model shortcuts** changes its layout while retaining saved ordering. The footer Model chip opens your saved scoped picker and restores keyboard focus when you close it.
|
|
20
|
+
|
|
21
|
+
The footer **Model** chip opens the saved scoped picker directly, retaining simple or provider-grouped layout, ordering, keyboard selection and Escape focus return. **All tools → /model** opens the complete model catalog, grouped alphabetically by provider. Within each provider, explicit release dates sort newest first; models without dates follow in alphabetical order by name. The current model stays marked within its group. Search retains matching provider groups. Your saved scoped-model ordering is unchanged. Footer model and effort controls show the session's effective values. Selecting a model applies it once and does not restart an in-progress response. Selecting effort while running or compacting saves it for the next prompt; the footer distinguishes current and pending effort. A failed selection stays in its picker with an error and can be retried. Global and exact-model defaults remain in Setup.
|
|
22
|
+
|
|
23
|
+
**Overview** in the conversation header opens a floating card at the top right. It shows the selected session’s folder, Git summary, runner, agents, queue, context and available provider limits. Select a row to open its controls. Close the card or use Overview again to dismiss it; this browser remembers your choice. Data that has not loaded is marked as unavailable or not loaded. The overview grows with its content and can reflow into columns when the conversation is wide enough. In short windows, you can scroll the whole card to reach content that cannot fit on screen. It does not start background refreshes or stop work when closed.
|
|
24
|
+
|
|
25
|
+
Dropdowns use the app’s theme. Browsers supporting customizable native selects also theme the expanded list; other browsers retain their native picker.
|
|
26
|
+
|
|
27
|
+
The compact composer has one submission button. **More** opens a single-row floating tray beside its trigger without shifting the prompt, transcript or Send button. In a narrow window, scroll the row to reach its remaining actions. Common options opens beside its own trigger. During a run it says **Steer run** or **Queue message**, matching the **During this run** choice and Enter. Steering supplies guidance during the run; it does not promise immediate interruption. Abort is a separate control. Classic and the independent phone/tablet modes retain their existing controls.
|
|
28
|
+
|
|
29
|
+
**Attention** in the lower-left rail shows waiting decisions separately from running sessions and work finished since it was last viewed. Opening the inbox does not mark finished output as read. Selecting an item opens its originating session, and pending decisions replay through the existing session connection. The urgent count includes only decisions. Metadata can identify a session and decision count before the full prompt is available.
|
|
30
|
+
|
|
31
|
+
Tools and Skills Setup keep Session, Global, and exact Model defaults separate. Changing the model in Setup does not change the session’s active model. An explicit empty selection differs from inheriting defaults. Disabled companions retain their existing Setup actions. Voice selection may download a voice. It saves the shared Pi voice configuration for future sessions and applies it to the active audio session. Opening Voice alone does not start the microphone. Provider login opens terminal sign-in guidance, while logout retains its confirmation. Restart, stop, and updates remain under System with their access restrictions. Restart and stop retain confirmation; selecting an update scope starts it immediately.
|
|
32
|
+
|
|
33
|
+
Open **Inspector** in the conversation header, then choose the **Project** or **Activity** tab at the top of the right panel. Its header is also the section picker, so every section is reachable without scrolling a row of tabs. Activity groups its sections by Work, Conversations, and Usage & diagnostics. Keyboard selection follows your platform’s standard select control. Files retain separate unsaved buffers per session; changing views does not save them or stop app runners. Agent output and conversation viewers remain read-only; stopping a run requires its explicit cancel action. The composer queue and Activity Queues operate on the same session queue, including edits, reordering, and removal. Provider usage remains account-wide.
|
|
34
|
+
|
|
35
|
+
A saved browser choice takes precedence over the server default. With no saved choice, a recognized fresh installation uses compact desktop; an existing installation, older server, unknown state, or custom settings location uses Classic. Invalid or unavailable browser storage also uses Classic. Opening an existing installation in a new browser, clearing browser storage, or changing its address does not turn it into a fresh installation. The installation choice is retained with Web UI settings; do not delete those settings to change your layout. To recover from a layout problem, add `?shell=classic` to the address, or `&shell=classic` when it already has a query. This forces Classic without deleting the saved preference. Remove that parameter to use your choice again. Switching layouts preserves the saved Classic arrangement; phone and tablet preview choices remain independent.
|
|
36
|
+
|
|
37
|
+
The compact layout is verified in Linux Chromium, including keyboard navigation and genuine 200% browser zoom. Physical mobile keyboards and IME, other browser engines, Windows/macOS devices, and live installed-companion combinations remain unverified.
|
|
38
|
+
|
|
39
|
+
### Session sidebar organization
|
|
40
|
+
|
|
41
|
+
Drag the compact sidebar’s right edge to resize it. Your width is saved in this browser. Focus the edge and use Left/Right arrows to adjust it, Shift for larger steps, or Home/End for the limits. Double-click the edge to reset its width; Escape cancels an active drag. Narrow windows temporarily limit the width to keep the conversation usable.
|
|
42
|
+
|
|
43
|
+
The compact left sidebar has Inbox, Working, and Settled sections. Settle and Restore affect only this browser and origin; other browsers, saved workspaces, Classic, and top-tab navigation retain their own presentation. Section expansion is remembered locally. Clearing browser storage removes these organization choices.
|
|
44
|
+
|
|
45
|
+
Settle is unavailable while a session is working or awaiting input. A new run, pending input, replaced conversation, or a newer completed run brings a settled session back automatically. Selecting a settled session alone does not restore it. App runners and known workflow runs count as active work. Read-only subagent views appear in Inbox or Working and retain their existing close behavior.
|
|
46
|
+
|
|
47
|
+
A group can appear in more than one section. Its membership is unchanged; closing a group fragment closes only the sessions listed in that section. Settle never stops work or closes a session. If browser storage is unavailable, changes last for the current page and the app reports that they could not be saved.
|
|
48
|
+
|
|
7
49
|
## Requirements
|
|
8
50
|
|
|
9
51
|
- Node.js 22.19 or newer
|
|
10
52
|
- Pi installed and configured
|
|
11
53
|
- A modern browser
|
|
12
54
|
|
|
55
|
+
## No Project conversations
|
|
56
|
+
|
|
57
|
+
Press the compact layout's **Pi** button or choose **New thread → No project** to open a fresh conversation without selecting a repository. Each fresh conversation receives its own directory under `~/.pi/agent/webui/no-project/`. If you set `PI_CODING_AGENT_DIR`, the directory is under that agent location instead. Opening an empty conversation does not allocate a folder or start Pi. The first submitted message creates its terminal and directory.
|
|
58
|
+
|
|
59
|
+
Paste text directly into the empty composer. File attachments require a running session; choose a project or send the first message before attaching files. If you submit a command that opens a dialog and navigate away while its conversation is being created, the command stays in that conversation's draft. Return there and submit it to open the dialog.
|
|
60
|
+
|
|
61
|
+
Unsent No Project text becomes a **Draft** in Inbox when you switch away. Drafts are saved in this browser for the same Web UI address, including port. They are not shared with another browser or device. Closing a draft discards it; drafts cannot be settled. You can also close the last real terminal: the Web UI returns to an empty No Project conversation without starting a replacement or deleting its working folder. If browser storage is unavailable or full, a message explains that edits remain only in the current page. Copy them before closing or reloading.
|
|
62
|
+
|
|
63
|
+
Your files remain after closing a tab. Resume, reopen and saved-workspace restoration reuse that conversation's directory. **New session** and `/new` from a No Project conversation open a new tab with a new directory and keep the old tab available. Choosing a project explicitly uses that project folder. Missing No Project folders produce an error rather than silently switching to another folder. There is no automatic deletion of these directories.
|
|
64
|
+
|
|
65
|
+
These folders separate working files; they are not a security sandbox. Pi still has the permissions and configured resources of the user running it.
|
|
66
|
+
|
|
13
67
|
## Install
|
|
14
68
|
|
|
15
69
|
```bash
|
|
@@ -31,6 +85,7 @@ Common options:
|
|
|
31
85
|
```text
|
|
32
86
|
/webui-start 31500
|
|
33
87
|
/webui-start --no-open
|
|
88
|
+
/webui-start --cwd ~/src/my-project
|
|
34
89
|
/webui-start --name browser
|
|
35
90
|
/webui-start --remote-auth --host 0.0.0.0
|
|
36
91
|
```
|
|
@@ -61,7 +116,7 @@ Useful options:
|
|
|
61
116
|
- `--remote-auth` enables PIN protection for non-local browsers.
|
|
62
117
|
- `--migration-dry-run` previews optional-feature migration without changing packages.
|
|
63
118
|
|
|
64
|
-
|
|
119
|
+
Without `--cwd`, a fresh start opens **No Project** with no active session or Pi child. The first submitted message creates a conversation and its own working directory. Existing supervised sessions and explicit restore information take precedence. This does not enable `--no-session`; conversations still persist normally.
|
|
65
120
|
|
|
66
121
|
## Settings and storage
|
|
67
122
|
|
|
@@ -81,19 +136,29 @@ Private runtime and recovery files should not be edited or removed while Web UI
|
|
|
81
136
|
|
|
82
137
|
## Pi and Web UI updates
|
|
83
138
|
|
|
84
|
-
|
|
139
|
+
Open **Updates** beside Settings. Choose a scope to start immediately:
|
|
140
|
+
|
|
141
|
+
- **Pi only** runs `pi update` using Pi on your PATH.
|
|
142
|
+
- **WebUI only** checks the global npm installation and the Pi agent's npm installation. It runs `npm update -g @firstpick/pi-package-webui` for the global copy and `pi update --extension npm:@firstpick/pi-package-webui` for the Pi-managed copy. Missing copies are reported and are not installed.
|
|
143
|
+
- **Pi and extensions + WebUI** runs `pi update --all` and updates a separate global npm WebUI copy if present. Pi-managed WebUI is already included in the all-extensions command. Pi handles its configured packages normally; `--all` can restore a configured package whose files are missing.
|
|
85
144
|
|
|
86
|
-
|
|
145
|
+
The update commands use your existing Pi and npm configuration. WebUI does not require a specific Pi version or perform ownership, idle-session or post-update health checks. Command failures are shown directly, without retrying with alternative commands. Only one update job runs at a time in this WebUI server. The result reports command exit status, not an independent verification of the new installation.
|
|
87
146
|
|
|
88
|
-
|
|
147
|
+
A progress card stays visible after you select an update. It shows the current command step, elapsed time and recent output. The percentage is a time-based estimate, not a download measurement; slow commands can remain near completion until they exit. Failures and lost connections are shown without claiming completion. Use **Details** to inspect the job’s commands, individual results and output. **Back to progress** returns to the running card; once finished, this control becomes **Back to result**. Opening Updates shows the scope choices, with **Back to progress** only while commands are running. Dismiss closes a finished card. Reopening Updates keeps the concise result text without reopening the dismissed card.
|
|
89
148
|
|
|
90
|
-
|
|
149
|
+
When every command explicitly reports that its target is already up to date, the compact result shows only **Already up to date**, the component name, and Details/Dismiss controls. No restart is needed; output and timing remain available in Details. Successful output that does not identify whether anything changed is reported as commands completed.
|
|
150
|
+
|
|
151
|
+
The server stays running during the commands. Restart WebUI after successful updates to load changed code. Progress and command results remain available while that server process runs; they are not a durable update history after a server restart. If a connection or process is lost during an update, inspect the host before rerunning the commands.
|
|
152
|
+
|
|
153
|
+
Only localhost can start updates. Package lifecycle scripts run with your existing configuration and are not sandboxed. The updater does not elevate permissions, and native package updates cannot be automatically rolled back. Review command output for private information before sharing it. If a command reports `EROFS`, its installation is on a read-only filesystem. Use a writable installation or run outside the read-only sandbox; the updater does not change mounts or permissions.
|
|
91
154
|
|
|
92
155
|
## Session continuity
|
|
93
156
|
|
|
94
157
|
The working-directory picker accepts a direct path for first, new, and split terminals and for cwd changes. On Windows, enter a rooted drive path such as `C:/` or `D:/project` to switch drives. From a drive root, **Parent** opens a **This PC** view listing ready filesystem drives; choose a drive to browse its root. **This PC** is navigation-only, so search and direct path entry remain available while selecting, creating, or pinning that virtual location is disabled. Web UI loads and validates a directory before it can be selected; an invalid or unavailable path remains in the field so you can correct it.
|
|
95
158
|
|
|
96
|
-
|
|
159
|
+
**Escape** or **Cancel** closes the directory picker even while a folder is loading. Cancellation returns keyboard focus to the visible control that opened it, unless you have moved to another tab or view. The **New thread** palette and the empty-screen folder dropdown render in the top layer, so scrolling lists cannot clip them.
|
|
160
|
+
|
|
161
|
+
When tabs span multiple working directories, a directory with one tab stays a normal, non-dropdown tab. Hover over it—or focus controls within it—to reveal **+ Thread** directly below, matching the placement used by grouped terminal menus without repeating the current tab. Directories with multiple tabs continue to use the grouped terminal menu.
|
|
97
162
|
|
|
98
163
|
Restarting only the Web UI normally keeps managed Pi tabs, working folders, saved sessions, and active work connected to the replacement server. Choosing a saved session from `/resume` opens it in a separate terminal tab and leaves the current terminal unchanged.
|
|
99
164
|
|
|
@@ -126,7 +191,7 @@ Prompt-impact indicators distinguish initial system-prompt text (`+`), condition
|
|
|
126
191
|
- **Retry failed** retries only failed package installs.
|
|
127
192
|
- **Copy commands** provides manual Pi install commands.
|
|
128
193
|
- **Recheck** repeats the read-only package check.
|
|
129
|
-
- **Install all** selects
|
|
194
|
+
- **Install all** selects companions eligible for bulk installation. A section's **Install missing** limits that selection to its section. Both use one confirmation, install sequentially, and continue after individual failures. Features with unknown status, registration problems, conflicts, updates or disabled access may need individual review. The summary explains exclusions; check each card's available action before proceeding.
|
|
130
195
|
- Configurable loaded companions show separate **Enable/Disable** and **Setup** actions. The loaded **TUI Skills command** and **TUI Tools command** rows open the browser-native Skills Setup and Tools Setup dialogs. Native questionnaires use the real active-session `questionnaire` tool state and expose only direct **Enable/Disable** access controls.
|
|
131
196
|
|
|
132
197
|
Installs run one at a time and never invent percentage progress. Busy tabs are not restarted without a visible follow-up action. For unattended migration, use `--migrate-optional-features`; use `--migration-dry-run` to print the planned audit-selected migration without changing packages.
|
|
@@ -145,7 +210,7 @@ Normal output shows the full live tool and response stream. Compact output keeps
|
|
|
145
210
|
|
|
146
211
|
Completed responses replace streamed drafts, including shortened or removed thinking. Refreshing history does not restore text removed by the provider. On older Pi releases, tool arguments stay hidden until Pi identifies the tool, which may happen only when argument generation completes. This keeps Intercom transport content out of the main transcript.
|
|
147
212
|
|
|
148
|
-
Choose the mode under **Controls → Output processing** or **Settings →
|
|
213
|
+
Choose the mode under **Controls → Output processing** or **compact Settings → System**, then select **Compact**. The stable setting and command-line identifier is `compact-v1`. The setting affects display only; it does not change Pi prompts, tools, models, saved transcript meaning, or inference.
|
|
149
214
|
|
|
150
215
|
## Code block syntax highlighting
|
|
151
216
|
|
|
@@ -394,6 +459,8 @@ At the phone/coarse-pointer breakpoint, the legacy mobile shell collapses termin
|
|
|
394
459
|
|
|
395
460
|
The optional Mobile Experience v2 shell remains separately controlled by its existing preview setting and is not changed by this legacy mobile layout. Tablet adaptation is independently opt-in at medium widths with `?tabletShell=v2`; use `?tabletShell=legacy` for immediate rollback without changing the phone preview flag.
|
|
396
461
|
|
|
462
|
+
For recovery, add `shell=classic` to the address, for example `http://127.0.0.1:31415/?shell=classic`. It bypasses phone and tablet previews for that page, including after resizing. Remove it to restore your saved choices; it does not reset your layout or sessions.
|
|
463
|
+
|
|
397
464
|
## Git panel
|
|
398
465
|
|
|
399
466
|
The side-panel **Git** section groups repositories represented by open terminal tabs. Expanding a repository refreshes stale status after a five-minute cache window; live filesystem updates use server-sent events (SSE) to invalidate visible results without periodic Git polling. The context menu provides refresh, stage/unstage, and confirmed discard/delete actions. History shows the latest 30 commits and opens bounded read-only commit diffs.
|