@firstpick/pi-package-webui 0.11.0 → 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.
Files changed (318) hide show
  1. package/DEVELOPMENT.md +181 -12
  2. package/README.md +41 -9
  3. package/TECHNICAL.md +91 -8
  4. package/bin/pi-webui.mjs +5432 -11428
  5. package/index.ts +10 -3
  6. package/lib/codex-cli-usage.mjs +232 -0
  7. package/lib/codex-usage-auth.mjs +39 -3
  8. package/lib/codex-usage-source.mjs +36 -0
  9. package/lib/component-update-state.mjs +2 -2
  10. package/lib/git-workflow-preference-values.mjs +122 -0
  11. package/lib/git-workflow-preferences.mjs +35 -563
  12. package/lib/package-updates.mjs +260 -0
  13. package/lib/rpc-supervisor-client.mjs +8 -4
  14. package/lib/server/app-runners.mjs +1667 -0
  15. package/lib/server/codex-fast-mode.mjs +161 -0
  16. package/lib/server/conversation-mode.mjs +218 -0
  17. package/lib/server/conversation-voice.mjs +318 -0
  18. package/lib/server/extension-ui-requests.mjs +114 -0
  19. package/lib/server/git-generation.mjs +459 -0
  20. package/lib/server/git-mutations.mjs +1827 -0
  21. package/lib/server/git-reads.mjs +608 -0
  22. package/lib/server/git-worktree-sessions.mjs +408 -0
  23. package/lib/server/helper-requests.mjs +82 -0
  24. package/lib/server/no-project-workspaces.mjs +103 -0
  25. package/lib/server/rpc-transports.mjs +394 -0
  26. package/lib/server/settings-store.mjs +544 -0
  27. package/lib/server/sse-delivery.mjs +138 -0
  28. package/lib/server/workspace-files.mjs +563 -0
  29. package/lib/update/supervisor.mjs +4 -0
  30. package/lib/webui-workspaces.mjs +2 -0
  31. package/package.json +5 -5
  32. package/public/activity-agents-controller.mjs +269 -0
  33. package/public/activity-events-controller.mjs +236 -0
  34. package/public/activity-intercom-controller.mjs +627 -0
  35. package/public/activity-queue-controller.mjs +534 -0
  36. package/public/activity-todo-view.mjs +89 -0
  37. package/public/activity-usage-controller.mjs +589 -0
  38. package/public/app.js +3761 -3878
  39. package/public/conversation-overview.css +84 -0
  40. package/public/conversation-overview.mjs +193 -0
  41. package/public/draft-conversations.mjs +135 -0
  42. package/public/focused-composer-controls.css +111 -0
  43. package/public/focused-composer-controls.mjs +143 -0
  44. package/public/focused-composer-disclosure.mjs +223 -0
  45. package/public/focused-shell-adapter.css +264 -0
  46. package/public/focused-shell-adapter.mjs +257 -0
  47. package/public/index.html +137 -80
  48. package/public/model-catalog-order.mjs +63 -0
  49. package/public/platform-event-stream.mjs +64 -0
  50. package/public/project-artifact-controller.mjs +218 -0
  51. package/public/project-file-viewer-controller.mjs +383 -0
  52. package/public/project-git-tools-controller.mjs +181 -0
  53. package/public/project-runners-controller.mjs +220 -0
  54. package/public/service-worker.js +52 -1
  55. package/public/session-attention-scheduler.mjs +182 -0
  56. package/public/session-composer-store.mjs +56 -0
  57. package/public/session-context.mjs +51 -0
  58. package/public/session-extension-requests.mjs +63 -0
  59. package/public/session-shelf-state.mjs +151 -0
  60. package/public/session-shelves.css +171 -0
  61. package/public/session-shelves.mjs +95 -0
  62. package/public/settings-navigation-controller.mjs +249 -0
  63. package/public/settings-navigation.css +61 -0
  64. package/public/settings-resource-controller.mjs +232 -0
  65. package/public/settings-workspace.css +19 -0
  66. package/public/settings-workspace.mjs +175 -0
  67. package/public/shell-actions.mjs +87 -0
  68. package/public/shell-attention-inbox.css +72 -0
  69. package/public/shell-attention-inbox.mjs +198 -0
  70. package/public/shell-context-actions.css +61 -0
  71. package/public/shell-context-actions.mjs +168 -0
  72. package/public/shell-inspector-resize.mjs +124 -0
  73. package/public/shell-navigation-resize.mjs +107 -0
  74. package/public/shell-navigation.mjs +127 -0
  75. package/public/shell-preferences.mjs +108 -0
  76. package/public/shell-surfaces.mjs +99 -0
  77. package/public/shell-tools-launcher.css +97 -0
  78. package/public/shell-tools-launcher.mjs +222 -0
  79. package/public/shell-view-host.mjs +115 -0
  80. package/public/shell-workspace.css +266 -0
  81. package/public/shell-workspace.mjs +402 -0
  82. package/public/sidebar-update-menu.css +190 -0
  83. package/public/sidebar-update-menu.mjs +512 -0
  84. package/public/styles.css +320 -169
  85. package/public/subagent-launch-slot-state.mjs +2 -2
  86. package/public/theme-contract.mjs +1 -1
  87. package/public/themed-selects.css +156 -0
  88. package/public/workspace-choices.mjs +104 -0
  89. package/tests/activity-agents-controller.test.mjs +652 -0
  90. package/tests/activity-events-controller.test.mjs +511 -0
  91. package/tests/app-runner-terminal-static.test.mjs +3 -3
  92. package/tests/append-system-http.test.mjs +7 -6
  93. package/tests/append-system-selector-static.test.mjs +6 -6
  94. package/tests/aur-review-widget-static.test.mjs +11 -3
  95. package/tests/boot-failure-diagnostics.test.mjs +8 -3
  96. package/tests/browser/activity-intercom-controller.spec.mjs +457 -0
  97. package/tests/browser/activity-navigation-integration.spec.mjs +45 -0
  98. package/tests/browser/activity-owner-integration.spec.mjs +201 -0
  99. package/tests/browser/activity-queue-controller.spec.mjs +405 -0
  100. package/tests/browser/activity-section-picker.spec.mjs +294 -0
  101. package/tests/browser/activity-todo-view.spec.mjs +60 -0
  102. package/tests/browser/activity-usage-controller.spec.mjs +416 -0
  103. package/tests/browser/compact-layout-integration.spec.mjs +58 -0
  104. package/tests/browser/composer-action-grid-reorder.spec.mjs +16 -0
  105. package/tests/browser/composer-disclosure.spec.mjs +389 -0
  106. package/tests/browser/composer-toolbar-polish.spec.mjs +343 -0
  107. package/tests/browser/control-deck-component-updates.spec.mjs +5 -14
  108. package/tests/browser/control-deck-side-panels.spec.mjs +27 -12
  109. package/tests/browser/control-visibility.spec.mjs +5 -0
  110. package/tests/browser/controls-layout.spec.mjs +21 -2
  111. package/tests/browser/conversation-overview.spec.mjs +251 -0
  112. package/tests/browser/draft-conversations.spec.mjs +276 -0
  113. package/tests/browser/empty-startup-fixture.mjs +135 -0
  114. package/tests/browser/empty-startup.spec.mjs +282 -0
  115. package/tests/browser/events-tree-context-menu.spec.mjs +1 -0
  116. package/tests/browser/focused-composer-more.spec.mjs +127 -0
  117. package/tests/browser/focused-model-shortcuts.spec.mjs +120 -0
  118. package/tests/browser/focused-navigation-fixture.mjs +32 -0
  119. package/tests/browser/focused-project-activity.spec.mjs +111 -0
  120. package/tests/browser/focused-shell-integration.spec.mjs +208 -0
  121. package/tests/browser/folder-picker-layout-fixture.mjs +13 -0
  122. package/tests/browser/folder-picker-layout.spec.mjs +302 -0
  123. package/tests/browser/footer-model-advanced-layout.spec.mjs +27 -14
  124. package/tests/browser/git-setup-cancel.spec.mjs +251 -0
  125. package/tests/browser/guided-git-fallback.spec.mjs +40 -21
  126. package/tests/browser/inspector-header.spec.mjs +221 -0
  127. package/tests/browser/inspector-overview-integration.spec.mjs +104 -0
  128. package/tests/browser/inspector-resize.spec.mjs +227 -0
  129. package/tests/browser/inspector-topic-overflow.spec.mjs +56 -0
  130. package/tests/browser/interaction-action-discovery.spec.mjs +332 -0
  131. package/tests/browser/interaction-attention-inbox.spec.mjs +364 -0
  132. package/tests/browser/interaction-attention-integration.spec.mjs +53 -0
  133. package/tests/browser/interaction-composer-controls.spec.mjs +267 -0
  134. package/tests/browser/interaction-composer-integration.spec.mjs +175 -0
  135. package/tests/browser/interaction-continuity.spec.mjs +50 -26
  136. package/tests/browser/interaction-model-picker.spec.mjs +86 -0
  137. package/tests/browser/last-terminal-close.spec.mjs +280 -0
  138. package/tests/browser/mobile-foundation.spec.mjs +172 -20
  139. package/tests/browser/model-catalog-groups.spec.mjs +104 -0
  140. package/tests/browser/more-row-menus.spec.mjs +258 -0
  141. package/tests/browser/new-tab-hit-target.spec.mjs +228 -0
  142. package/tests/browser/no-project-conversation.spec.mjs +113 -0
  143. package/tests/browser/optimistic-prompt.spec.mjs +3 -0
  144. package/tests/browser/overhaul-w7-accessibility.spec.mjs +227 -0
  145. package/tests/browser/overhaul-w7-capabilities.spec.mjs +298 -0
  146. package/tests/browser/overhaul-w7-companions.spec.mjs +290 -0
  147. package/tests/browser/overhaul-w7-focus-repairs.spec.mjs +210 -0
  148. package/tests/browser/overhaul-w7-layout-repairs.spec.mjs +183 -0
  149. package/tests/browser/overhaul-w7-parent-repairs.spec.mjs +97 -0
  150. package/tests/browser/overhaul-w7-pwa.spec.mjs +247 -0
  151. package/tests/browser/overhaul-w7-responsive.spec.mjs +450 -0
  152. package/tests/browser/overhaul-w7-update.spec.mjs +215 -0
  153. package/tests/browser/overhaul-w7-zoom.spec.mjs +243 -0
  154. package/tests/browser/overview-agent-ownership.spec.mjs +45 -0
  155. package/tests/browser/persistent-ui-layout.spec.mjs +3 -0
  156. package/tests/browser/project-artifact-controller.spec.mjs +324 -0
  157. package/tests/browser/project-artifact-integration.spec.mjs +103 -0
  158. package/tests/browser/project-file-buffer-integration.spec.mjs +230 -0
  159. package/tests/browser/project-git-tools-integration.spec.mjs +369 -0
  160. package/tests/browser/session-fixture.mjs +118 -0
  161. package/tests/browser/session-ownership.spec.mjs +175 -0
  162. package/tests/browser/session-shelves-integration.spec.mjs +219 -0
  163. package/tests/browser/session-shelves.spec.mjs +340 -0
  164. package/tests/browser/session-sidebar-resize.spec.mjs +138 -0
  165. package/tests/browser/session-summary.spec.mjs +17 -12
  166. package/tests/browser/settings-complete-home.spec.mjs +463 -0
  167. package/tests/browser/settings-entrypoint.spec.mjs +104 -0
  168. package/tests/browser/settings-navigation-controller.spec.mjs +383 -0
  169. package/tests/browser/settings-navigation-integration.spec.mjs +348 -0
  170. package/tests/browser/settings-resource-lifetime.spec.mjs +349 -0
  171. package/tests/browser/settings-workspace-integration.spec.mjs +132 -0
  172. package/tests/browser/shell-ownership.spec.mjs +398 -0
  173. package/tests/browser/shell-rollout-fixture.mjs +259 -0
  174. package/tests/browser/shell-rollout.spec.mjs +357 -0
  175. package/tests/browser/shell-tools-launcher.spec.mjs +260 -0
  176. package/tests/browser/shell-workspace.spec.mjs +433 -0
  177. package/tests/browser/side-panel-section-reorder.spec.mjs +3 -1
  178. package/tests/browser/sidebar-floating-tooltips.spec.mjs +37 -0
  179. package/tests/browser/sidebar-update-integration.spec.mjs +277 -0
  180. package/tests/browser/sidebar-update-menu.spec.mjs +402 -0
  181. package/tests/browser/sidebar-update-progress.spec.mjs +472 -0
  182. package/tests/browser/stream-output-isolation.spec.mjs +6 -3
  183. package/tests/browser/themed-selects.spec.mjs +297 -0
  184. package/tests/browser/thread-start-flow.spec.mjs +481 -0
  185. package/tests/browser/ui-polish-activity-controls.spec.mjs +177 -0
  186. package/tests/browser/ui-polish-features.spec.mjs +85 -0
  187. package/tests/browser/ui-polish-file-header.spec.mjs +43 -0
  188. package/tests/browser/ui-polish-local-git.spec.mjs +183 -0
  189. package/tests/browser/ui-polish-mobile-recovery.spec.mjs +36 -0
  190. package/tests/browser/ui-polish-navigation.spec.mjs +127 -0
  191. package/tests/browser/ui-polish-session-actions.spec.mjs +282 -0
  192. package/tests/browser/user-noticeable-fixes.spec.mjs +10 -3
  193. package/tests/browser/windows-drive-parent.spec.mjs +4 -2
  194. package/tests/browser/workspace-draft-selection.spec.mjs +266 -0
  195. package/tests/codex-cli-usage.test.mjs +189 -0
  196. package/tests/codex-fast-mode-static.test.mjs +16 -11
  197. package/tests/codex-speed-mode-browser-state.test.mjs +6 -3
  198. package/tests/codex-usage-auth.test.mjs +168 -9
  199. package/tests/codex-usage-http.test.mjs +124 -0
  200. package/tests/codex-usage-source.test.mjs +146 -0
  201. package/tests/component-update-api-static.test.mjs +2 -2
  202. package/tests/composer-action-grid-reorder-static.test.mjs +3 -3
  203. package/tests/control-deck-component-updates-static.test.mjs +9 -4
  204. package/tests/control-visibility-static.test.mjs +3 -3
  205. package/tests/controls-layout-static.test.mjs +5 -5
  206. package/tests/conversation-overview-adapter.test.mjs +100 -0
  207. package/tests/document-artifact-static.test.mjs +2 -1
  208. package/tests/draft-conversations.test.mjs +205 -0
  209. package/tests/empty-startup-launcher.test.mjs +197 -0
  210. package/tests/events-tree-context-menu-static.test.mjs +22 -18
  211. package/tests/fake-pi-session-ownership.test.mjs +302 -0
  212. package/tests/fast-mode-client-static.test.mjs +1 -1
  213. package/tests/feature-decision-output-popup-static.test.mjs +2 -2
  214. package/tests/feature-system-prompt-optional-feature-static.test.mjs +1 -1
  215. package/tests/file-viewer-image-static.test.mjs +15 -11
  216. package/tests/file-viewer-search-static.test.mjs +5 -5
  217. package/tests/fixtures/fake-codex-app-server.mjs +61 -0
  218. package/tests/fixtures/fake-pi.mjs +41 -9
  219. package/tests/footer-provider-usage-visual-static.test.mjs +7 -6
  220. package/tests/foreground-transcript-catch-up-static.test.mjs +7 -4
  221. package/tests/git-footer-context-menu-static.test.mjs +1 -1
  222. package/tests/git-panel-file-preview-static.test.mjs +41 -48
  223. package/tests/git-panel-live-updates-static.test.mjs +2 -1
  224. package/tests/git-workflow-dispatch.test.mjs +66 -0
  225. package/tests/git-workflow-preferences.test.mjs +9 -1
  226. package/tests/guided-git-activation-static.test.mjs +14 -11
  227. package/tests/guided-git-fallback-ui-static.test.mjs +8 -5
  228. package/tests/guided-git-message-reliability-static.test.mjs +10 -6
  229. package/tests/guided-git-publication-backend-static.test.mjs +16 -11
  230. package/tests/http-endpoints-harness.test.mjs +29 -9
  231. package/tests/interaction-state-stability-static.test.mjs +4 -3
  232. package/tests/intercom-conversation-viewer-static.test.mjs +29 -17
  233. package/tests/intercom-tag-layout-static.test.mjs +13 -12
  234. package/tests/intercom-tag-overflow-layout.test.mjs +11 -10
  235. package/tests/main-output-loading-static.test.mjs +4 -4
  236. package/tests/middle-button-drag-scroll-static.test.mjs +3 -3
  237. package/tests/mobile-compact-layout.test.mjs +2 -2
  238. package/tests/mobile-continuity-tablet-static.test.mjs +3 -3
  239. package/tests/mobile-foundation-static.test.mjs +10 -7
  240. package/tests/mobile-phone-experience-static.test.mjs +3 -2
  241. package/tests/mobile-static.test.mjs +173 -135
  242. package/tests/model-catalog-order.test.mjs +103 -0
  243. package/tests/native-parity.test.mjs +6 -4
  244. package/tests/native-session-choice-owner.test.mjs +102 -0
  245. package/tests/native-update-lifecycle.test.mjs +10 -5
  246. package/tests/no-project-http-harness.test.mjs +328 -0
  247. package/tests/no-project-navigation.test.mjs +54 -0
  248. package/tests/no-project-workspaces.test.mjs +77 -0
  249. package/tests/open-issue-wizard-static.test.mjs +1 -1
  250. package/tests/optional-feature-migration-frontend.test.mjs +4 -4
  251. package/tests/optional-feature-prompt-impact-static.test.mjs +3 -3
  252. package/tests/package-updates.test.mjs +630 -0
  253. package/tests/persistent-ui-layout-static.test.mjs +3 -3
  254. package/tests/platform-event-stream.test.mjs +253 -0
  255. package/tests/project-file-viewer-controller.test.mjs +652 -0
  256. package/tests/project-git-tools-adapter.test.mjs +103 -0
  257. package/tests/project-git-tools-controller.test.mjs +577 -0
  258. package/tests/project-runners-controller.test.mjs +453 -0
  259. package/tests/prompt-input-vertical-scroll-static.test.mjs +3 -3
  260. package/tests/prompt-routing-input-clear-static.test.mjs +2 -2
  261. package/tests/questionnaire-dialog.test.mjs +6 -6
  262. package/tests/queue-edit-reorder-static.test.mjs +48 -51
  263. package/tests/rpc-supervisor-host.test.mjs +4 -1
  264. package/tests/safety-guard-auto-review-static.test.mjs +1 -1
  265. package/tests/sampling-native-controls-user-flow.test.mjs +7 -1
  266. package/tests/server-app-runners.test.mjs +536 -0
  267. package/tests/server-codex-fast-mode.test.mjs +346 -0
  268. package/tests/server-conversation-mode.test.mjs +386 -0
  269. package/tests/server-conversation-voice.test.mjs +426 -0
  270. package/tests/server-extension-ui-requests.test.mjs +357 -0
  271. package/tests/server-git-generation.test.mjs +558 -0
  272. package/tests/server-git-mutations.test.mjs +729 -0
  273. package/tests/server-git-reads.test.mjs +381 -0
  274. package/tests/server-git-worktree-sessions.test.mjs +502 -0
  275. package/tests/server-helper-requests.test.mjs +364 -0
  276. package/tests/server-rpc-transports.test.mjs +553 -0
  277. package/tests/server-settings-store.test.mjs +132 -0
  278. package/tests/server-shell-rollout.test.mjs +478 -0
  279. package/tests/server-sse-delivery.test.mjs +410 -0
  280. package/tests/server-workspace-files.test.mjs +546 -0
  281. package/tests/session-attention-scheduler.test.mjs +514 -0
  282. package/tests/session-composer-store.test.mjs +153 -0
  283. package/tests/session-context.test.mjs +134 -0
  284. package/tests/session-extension-requests.test.mjs +193 -0
  285. package/tests/session-ownership-adapter.test.mjs +130 -0
  286. package/tests/session-sampling-ui-static.test.mjs +10 -4
  287. package/tests/session-send-lifetime.test.mjs +140 -0
  288. package/tests/session-shelf-state.test.mjs +348 -0
  289. package/tests/session-shelves-adapter.test.mjs +79 -0
  290. package/tests/session-summary-lifetime.test.mjs +54 -0
  291. package/tests/settings-resource-controller.test.mjs +548 -0
  292. package/tests/shell-action-adapter.test.mjs +169 -0
  293. package/tests/shell-actions.test.mjs +182 -0
  294. package/tests/shell-navigation.test.mjs +348 -0
  295. package/tests/shell-preferences.test.mjs +367 -0
  296. package/tests/side-panel-section-height-removal-static.test.mjs +3 -3
  297. package/tests/stream-output-isolation-static.test.mjs +1 -1
  298. package/tests/subagent-gate-visibility.test.mjs +1 -1
  299. package/tests/subagent-launch-slot-state.test.mjs +2 -2
  300. package/tests/subagent-launch-slots-static.test.mjs +1 -1
  301. package/tests/subagent-observability-static.test.mjs +2 -2
  302. package/tests/subagent-reliability-integration.test.mjs +13 -30
  303. package/tests/syntax-highlighting-static.test.mjs +3 -3
  304. package/tests/tab-close-continuity-static.test.mjs +1 -1
  305. package/tests/tab-metadata-ordering.test.mjs +99 -0
  306. package/tests/terminal-cwd-grouping-static.test.mjs +2 -2
  307. package/tests/terminal-tab-prompt-tooltip-static.test.mjs +2 -0
  308. package/tests/terminal-tab-workspace-static.test.mjs +5 -4
  309. package/tests/terminal-tabs-resize-static.test.mjs +1 -1
  310. package/tests/theme-contract.test.mjs +10 -3
  311. package/tests/theme-customizer-static.test.mjs +1 -1
  312. package/tests/thread-display-title.test.mjs +44 -0
  313. package/tests/update-api-harness.test.mjs +15 -14
  314. package/tests/update-tab-restore-harness.test.mjs +3 -0
  315. package/tests/webui-settings-locking.test.mjs +2 -2
  316. package/tests/windows-drive-cwd-picker-static.test.mjs +7 -9
  317. package/tests/workspace-choices.test.mjs +114 -0
  318. 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
- If `--cwd` is omitted, the browser asks which project to open first.
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
- Use **Update Pi** and **Update Web UI** separately from localhost. Each action previews the exact executable, command, affected installation roots, working directory, Pi agent directory, npm prefix where relevant, and skipped installations. Confirm only after reviewing that list. If an executable, owner, or installation changes before launch, request a new preview. A small spinner means the job is still being checked, not a percentage estimate. Its ID, bounded command output and per-installation result remain visible after reconnect.
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.
144
+
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.
146
+
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.
85
148
 
86
- **Update Pi** runs `pi update` with the verified PATH Pi, not necessarily the Pi currently running your tabs. Initial automatic support is proven only for PATH Pi 0.87.1; other versions get manual or unproven guidance. The separately selected, bundled, or explicit Pi runtime is not silently replaced. **Update Web UI** runs `npm -g update @firstpick/pi-package-webui` for a proven npm-global installation and `pi update --extension npm:@firstpick/pi-package-webui --no-approve` for a proven Pi user installation, using its configured npm range or tag. Eligible installations run in sequence. Project copies, exact pins, Git/local sources and unproven ownership need manual attention. No optional companion packages are included.
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.
87
150
 
88
- Finish known affected Pi work before updating. PowerShell or Bash runs in the background; a desktop terminal is not needed. Native package lifecycle scripts run with your existing configuration and are not sandboxed. The updater does not elevate permissions. Native package updates may change dependencies and cannot be automatically rolled back. The displayed output is bounded and masks common credential patterns, but arbitrary script output may still expose secrets. Do not paste it into a public issue without checking it.
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.
89
152
 
90
- A changed, verified healthy active component restarts automatically once all commands finish and affected work is idle, even when another installation failed. Unchanged, failed or unverified active installations do not auto-restart. Partial and unknown results stay visible after reconnect; unknown completion blocks retry and restart until you verify and recover on the host. A short interruption is possible; zero downtime is not promised. The launcher can migrate old managed-runtime pointers only to a validated, compatible equal-or-newer installed Web UI. It retains pointer backups and old runtimes. A failed validation or downgrade keeps the old launch path with manual guidance; this is not rollback of a native update.
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
- 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 **+ Tab** 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.
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 every missing or unregistered companion. A section's **Install missing** selects only missing or unregistered companions in that section. Both use one confirmation, install sequentially, and continue after individual failures.
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 → Browser workflow**, 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.
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
 
@@ -184,6 +249,20 @@ Behavior and limits:
184
249
  - Coloring is intentionally approximate rather than a full language parser. Unusual constructs such as nested string interpolation, shell heredocs, PowerShell here-strings, or embedded scripts inside markup may be colored imprecisely; the code text itself is never altered.
185
250
  - Fenced `mermaid` and `mmd` blocks keep rendering as diagrams instead of highlighted source.
186
251
 
252
+ ## Codex subscription usage
253
+
254
+ The **Codex Usage** panel prefers your installed Codex CLI as its usage source. Run `codex login` and sign in with ChatGPT, verify with `codex login status`, then choose **Refresh usage** in Web UI. It reports the CLI account's subscription windows and reset times without starting a model turn, opening a Codex conversation, or redeeming usage resets. API-key and other provider logins cannot supply these subscription numbers.
255
+
256
+ Codex CLI's login is separate from Pi's. The panel labels **Codex CLI account** and warns that these limits may differ from Pi's newer ChatGPT-plan allowance. Sign into the intended account in Codex CLI. Web UI does not compare or display account IDs or email addresses, and choosing this source does not change Pi's login or model.
257
+
258
+ Codex CLI must be available to the account and environment running Web UI. It uses the CLI's existing configuration and `CODEX_HOME` if you have set it. Set `PI_WEBUI_CODEX_BIN` to an executable path if `codex` is not on that environment's PATH. Windows native executables and the standard npm installation are supported without a command shell; custom Windows script launchers need an executable or JavaScript entry point instead. Restart the Web UI after changing its launch environment. The adapter was verified with Codex CLI 0.162.1; older or incompatible versions fall back rather than starting model work.
259
+
260
+ The CLI check has a 15-second deadline plus bounded process cleanup. Concurrent requests share one check, successful results are cached for 30 seconds, and **Refresh usage** requests a fresh check. Failures are not cached. A missing CLI, missing ChatGPT login, timeout, or unusable response triggers the legacy fallback. Its source label makes the change visible.
261
+
262
+ The fallback uses a supported legacy Pi Codex subscription OAuth login. Keep Pi and Web UI on the same `PI_CODING_AGENT_DIR` when using a custom configuration location. Pi's newer **OpenAI → Sign in with ChatGPT** token cannot supply this legacy usage reader and is never refreshed or forwarded for that purpose. If neither source works, check [ChatGPT usage](https://chatgpt.com/settings/usage) directly.
263
+
264
+ Codex CLI manages its own authentication and normal token refresh. Web UI does not read its credential files, request a login flow, scrape terminal output, or publish raw CLI diagnostics. Tokens, email addresses, account IDs, and other raw account details never reach the browser. The legacy reader keeps Pi OAuth credentials server-side too.
265
+
187
266
  ## Codex subscription Fast mode
188
267
 
189
268
  The optional `@firstpick/pi-extension-codex-fast-mode` companion adds a **Normal / Fast / Ultrafast** selector under **Codex Usage**. Normal is the default. The preference belongs to the active Pi session branch, and changes are blocked while that tab is busy. The displayed mode is a preference, not proof that OpenAI accepted the tier.
@@ -380,6 +459,8 @@ At the phone/coarse-pointer breakpoint, the legacy mobile shell collapses termin
380
459
 
381
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.
382
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
+
383
464
  ## Git panel
384
465
 
385
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.
@@ -388,6 +469,8 @@ The side-panel **Git** section groups repositories represented by open terminal
388
469
 
389
470
  Use **Controls → Interface → Theme** to choose a theme.
390
471
 
472
+ Update WebUI and `@firstpick/pi-themes-bundle` together when moving to Pi 1.2. The updated bundle keeps native palettes valid under Pi's stricter theme checks, while WebUI retains the Catppuccin Mocha and Matrix background images.
473
+
391
474
  ### Custom themes
392
475
 
393
476
  **Customize…** opens a visual editor for Pi's exact 51 required theme tokens, optional colors, variables, and advanced JSON. Valid changes preview immediately. Invalid or incomplete edits remain editable but cannot replace the last valid preview or be saved.