aura web

Start a browser-based UI.

Syntax

aura web [flags]

Description

Starts an HTTP server for a browser-based chat interface. The web UI uses SSE (Server-Sent Events) for streaming responses and htmx for dynamic updates. Markdown is rendered with goldmark and syntax-highlighted with chroma.

Flags

Flag	Default	Description
--bind	127.0.0.1:9999	Address to bind

Plus all global flags.

Authentication

aura web does not include built-in authentication. By default it binds to 127.0.0.1, so only local processes can connect.

For remote access with authentication, place it behind a reverse proxy (e.g. nginx, Caddy, Traefik) that handles auth.

Session Persistence

Chat messages survive page reloads and multi-tab usage — the server replays the conversation to reconnecting clients.

Session management commands work in the web UI: /help renders a clickable command list, /resume shows an interactive session picker, and /save persists the conversation. The --resume and --continue global flags also work:

aura --continue web     # Resume most recent session in browser
aura --resume abc web   # Resume session by ID prefix

Examples

# Start on default port (auto-opens browser)
aura web

# Bind to a specific port
aura web --bind 127.0.0.1:8080

# With a specific agent
aura --agent high web

# Resume a previous session
aura --continue web