Web UI#
OpenProgram has one workspace UI. It is a React and Next.js app (apps/web/), built ahead of time and served by the Python worker on the same port as the API, so the same pages run in a browser tab, in the desktop app, and against a remote server. The desktop app (apps/desktop/) is an Electron shell around those pages for macOS and Windows; on Linux and on servers you open the Web UI in a browser.
How the workspace is laid out today:
- Sidebar and pages. The main sidebar lists projects and chats and opens Agents, Abilities (Programs, skills, plugins, MCP), Applications, History and Scheduler; Settings sits in the user menu. List pages share one secondary rail.
- Center tabs. The center area holds tabs for chats, files, terminals and web pages. A tab can be split into side-by-side panes, and tabs and groups can move between desktop windows.
- Chat transcript. A turn shows the model's reply with tool calls folded into summary rows, a file-change summary, sub-agent rows and any requests waiting for you; the transcript follows new output until you scroll away.
- Composer. The input box carries attachments, the model and effort pickers, per-folder git pills and the Options menu; local file paths survive into the model context.
- One visual system. Colours, sizes and shapes come from design tokens and themes; icons, indicator dots and hover tips each follow one rule set.
The documents below are the design of each of these surfaces:
invariants.md— cross-module UI invariants (walk the list before touching related modules)chat-transcript-follow.html— unified transcript follow: one attach/detach policy for send, stream, Jump to latest, session switch, and history windowschat-turn-visual-spec.html— chat-turn visual spec (execution timeline, file-change summary surface, manual function runs, and message minimap); file-history semantics live in the canonical runtime designtool-group-summary.html— header of a folded run of tool calls: summary grammar, +N −M change badge, running tense, and the turn-level summary decisionactivity-panel.md— the right sidebar's Activity: sub-agents as rows, the concrete issues that need you, and one page per rowsub-agent-row.md— a spawned agent's one step row: its status, its own conversation when opened,job_id-stamped frames, and branch transcript loadinteraction-feedback.md— the 0ms interaction-feedback rule (optimistic state first, data backfills)turn-occupancy.md— stop, send-queue, and session-slot occupancy (released on cancel intent)state-layer.md— web state layer: one store instance per session, with genuinely shared data globalcenter-tabs-and-split-layout.html— authoritative single-tab and composite split-tab lifecycle, rendering, persistence, and transfer designbuilt-in-browser.html— built-in browser home, browser-profile import, compact History, and the four-entry new-pane launcherbrowser-extensions.html— product decision not to support Chrome/Edge extension installation or management, retained browser capabilities, and the inert legacy-data boundaryintegrated-terminal.html— real PTY terminal and direct local Claude Code launchercomposer-local-attachment-paths.html— local attachment path preservation from the composer to model contextcomposer-responsive-controls.html— responsive composer controls and compact-state interaction contractcomposer-options-menu.html— Options (+) menu on the shared menu grammar; tools come from the Agent, not the menueffort-picker.html— the effort card: lavender level name and?help tip in the header, a neutral stepped track with a highest-level animated square field, the thumb's level tip, and the Recommended captionprograms-source-categories.html— Programs grouping and source-category behaviorcomposer-interaction-modes.md— composer interaction modesattachment-handling.html— complete attachment design: storage, admission, delivery, recovery, and acceptancechat-attachments.html— chat attachments both ways: what the transcript shows, how the agent hands a file back, how a readable file opensresource-preview.html— Resources list, chat operation preview and human takeover of Agent-operated Pagesagent-control-overlay.html— status pill and agent pointer drawn over a window or page the agent controls: placement, wording, motion, accent colour, and input safetyindicator-dots.md— indicator dotsagent-avatars.md— Agent avatars: the character an Agent wears, how it is stored and derived, where it shows, sources and licencesgit-folder-pills.md— per-folder git pill in the composer: branch, change counts, branch switch, worktrees, pull requestshover-tips.md— composer hover tips: oneHoverTip+TipBodylayout, title with current value, muted detail lineicons.md— icon system: which family goes where (Solar in the composer, animated line icons in the chrome, lucide elsewhere), motion contract, attributiondesign-tokens.md— design tokens: every size, shape and ink tier, and which component takes whichsurface-system.md— surface systemtheme-system.html— authoritative theme entry, complete token contract, component consumption, and desktop-overlay propagationsecondary-rail.md— the one list column between the main sidebar and a page's content (History projects, Agents, Programs tree, Settings): shared rows, collapse, button rolessettings-collapsible-columns.html— independent 49px collapse for the app and Settings nav; Providers list stays expanded with a full-width search fieldavatar-randomization.html— the user avatar picker: type first, then same-style variants or letter fieldsweb-styles.md— web style organization (one component, one file; directories mirror the component tree)window-state.md— desktop window bounds, maximize/fullscreen, and titlebar resize hit-testingwindow-lifecycle.md— one main window: launch, Dock activate, and second-instance share a single createwindow-tab-transfer.md— moving a tab, group segment, or group to another window or a torn-off one: one transaction, the same live web page, journals and rollback
Last updated · 2026-11-05