Web UI
The Web UI is Archonâs built-in management console. It uses Archonâs public API and does not require a separate hosted service.
Start the console
Section titled âStart the consoleâFor local development, start the API server and Vite frontend together:
bun run devThe console is available at http://localhost:5173; the API server listens on
http://localhost:3090.
You can also run them separately:
bun run dev:serverbun run dev:webFor a production build, the API server serves the compiled console on port 3090:
bun run buildbun run startThe backend binds to 0.0.0.0 by default. The Vite development server binds to
localhost; pass --host 0.0.0.0 only when you intentionally want to expose it:
bun run dev:web -- --host 0.0.0.0Authentication
Section titled âAuthenticationâAuthentication is optional. A solo installation with Web authentication disabled opens the console directly. When authentication is enabled, the same console requires a session and provides sign-in, signup when allowed by server policy, and sign-out.
Console navigation
Section titled âConsole navigationâThe project rail is the main navigation surface:
- Runs at
/consoleshows runs across projects. Selecting a project opens its scoped runs at/console/p/:projectId. - Chat at
/console/p/:projectId/chatopens the operator conversation for that project. - Settings at
/console/settingsmanages assistant defaults, model tiers, aliases, provider credentials, system status, GitHub identity, and alerts. - Workflow builder at
/console/builderopens the experimental visual authoring surface. Select a project before opening or creating a workflow.
Register a project with the add button in the rail. Remote Git URLs are cloned; local paths are registered in place. Removing a project removes its registration, not its files.
Workflows and runs
Section titled âWorkflows and runsâChoose a workflow from a projectâs run or chat view, supply its inputs, and launch it. The console follows execution through live events and exposes the governance actions that apply to the current state, including approval, rejection, resume, cancel, and abandon.
A run can be opened from a project at
/console/p/:projectId/r/:runId or directly by ID at
/console/r/:runId. Direct links also work for runs that have no registered
project. Run details include the event log and artifacts; a graph is shown when
the run has the project context needed to load its workflow definition.
Turn on Alerts in Settings to hear a sound, and see a browser notification where the browser allows it, when a run stops at an approval gate or an attention wait, or when it completes, fails, or is cancelled. The setting is saved in the current browser and is off by default. Runs that were already waiting or finished when the console loaded do not alert. Settings shows when the browser blocks the sound or notifications.
Old settings, workflow-list, workflow-builder, and run bookmarks redirect to the closest console route. Old chat and other retired pages land on the console overview because the conversation browser is no longer shipped.
Project chat
Section titled âProject chatâProject chat streams assistant text and tool activity. When Web authentication is enabled, the console requests the signed-in userâs project conversation and sends the active identity with each turn. On a solo installation, chat works without a user identity.
Attachments are limited to five files of at most 10 MB each. The first message in a new conversation cannot include attachments; create the conversation with a text message, then attach files on the next turn.
Experimental workflow builder
Section titled âExperimental workflow builderâThe builder is retained as a bounded experiment inside the console. Use its canvas, inspector, validation, and YAML preview to draft new workflows with prompt, command, bash, script, loop, approval, wait, and cancel nodes. Editing an existing workflow and relying on a load/edit/save round trip is not supported until #3378 and #3379 land. Edit existing workflows as YAML. The builder also does not represent include directives, loop groups, or workflow sub-run nodes. Workflow YAML remains the authoritative artifact.
