Dashboard

The Sophon Dashboard is a React 19 + TypeScript web app served by the Gateway at http://<gateway>:8080/ (default). It's the primary place you'll spend time in Sophon: chat lives there, agent management lives there, workflows are built there, approvals land there, and every setting has a screen.

This page is a map of the Dashboard so you know where things are.

Top-level navigation

The Dashboard has a left sidebar and a top header. The sidebar groups pages into sections:

• Home — personalized feed with insights, daily thought, AI summary, active tasks
• Chat — active sessions and new chat
• Agents — manage your agents
• Workflows — build, list, edit, run
• Skills — installed skills, marketplace, per-agent toggles
• Memory — entries, logs, search, entity graph
• Documents — library, upload, Q&A
• Tasks — active + history ledger
• Canvas — live code/artifact editor (opens automatically from chat)
• Claude Code — sandboxed coding sessions
• Discussions — multi-agent deliberation
• Voice — the full-screen voice page
• Command Bridge — live fleet view, with a hands-free voice bar
• Approvals — pending approval queue
• Admin (Admin role only) — Users, Roles, Audit, License, Compliance, Tenants
• Operations (Operator role) — System, Control, Remote Access
• Settings — everything that doesn't fit elsewhere

Per-page detail

Home

The landing page after login. Shows:

• Hero greeting with your streak and token budget
• Daily thought (rotating curated quote)
• AI-generated summary of your week
• Insight cards (activity trends, tool usage, milestones)
• Active tasks card (live-updating via SignalR)
• Recent sessions
• On-this-day reflection (1 year / 1 month / 1 week ago)

See Insights.

Chat

Left panel lists sessions; right panel is the active conversation. Features:

• Streaming responses, tool-call expansion, plan progress tracker
• Agent selector dropdown
• Per-session model picker in the chat inspector (Model Catalog)
• Channel selector (which channel this session belongs to)
• Edit Routing modal per channel — group reply policy, mention allowlist, debounce (Group Chats)
• Thread badge on sessions spawned from channel threads (Threads)
• Attach files (uploads to Documents)
• Voice ribbon — the mic opens a voice strip between the thread and the composer. It talks on the chat you have open, and switching chats ends voice on the old chat and restarts it on the new one rather than speaking into the wrong thread. It never reads approvals or questions aloud — those stay on the thread's own cards (Voice Surfaces)
• Question card v2 — when the agent asks for input, a structured card renders inline with up to four questions, option chips, and multi-select; typing in the composer answers the active question, so you never have to click through if you'd rather just type
• Approval and question cards say how a prompt ended — Approved, Rejected, Cancelled or Timed out, each as its own outcome rather than collapsing everything that isn't an approval into a red "Rejected". A card also closes itself when the same approval is answered somewhere else — another tab, the mobile app, a channel reply or by voice
• Agent activity — sessions the agent spawned for itself (delegation, subagents) are nested under an "Agent activity (n)" group on their parent session instead of cluttering the top-level list. Expand it to jump into a child session; a pulsing dot means one of them is still working
• Session search
• Fork / archive / delete per session

Agents

List view with one row per agent: name, description, default model, last activity. Click to edit:

• SOUL.md editor (with preview)
• Tool allowlist (per-skill toggles)
• Model preferences (primary + fallback)
• Heartbeat panel — checklist editor, autonomy toggles, run-now button, live run status (Heartbeat)
• AGENTS.md routing rules

Workflows

List + visual builder. Builder has a node palette, canvas, and inspector pane. See Workflows.

Skills

Grid view of installed skills with enable/disable per agent. Marketplace tab browses the Sophon Marketplace; installs show a permissions summary and require your confirmation — see Installing Packages. Self-authored tab shows skills the agent has generated. See Skills.

Memory

Four tabs:

• Entries — paginated list, filters, add/edit/delete
• Logs — daily activity log
• Search — hybrid keyword + semantic
• Graph — interactive entity graph

The Graph tab is the v2 explorer: force-directed layout, per-agent slot colors, kind-chip filters, a date window, node-cap presets, a co-mention overlay, and Mermaid export (Memory Graph). A Duplicates review sheet surfaces likely duplicate entities so you can merge or dismiss each pair.

See Memory.

Documents

Library grid with thumbnails. Click a doc to open detail view (extracted text, Q&A pane, metadata). The detail view includes a rich in-app viewer — PDF, spreadsheets, DOCX, images, audio, Markdown, Mermaid diagrams, and syntax-highlighted code all render inline. A Versions tab lists prior revisions of a document with per-version download. Batch button for multi-doc operations. See Documents.

Tasks

Active and History tabs. Live updates. See Tasks.

Canvas

Splitscreen chat + editor. Usually opens automatically when the agent generates a code artifact, but accessible directly at /canvas?session=<id>. Each frame has a toolbar with a version stepper (step through per-frame history) and width presets, and document frames open uploaded or generated documents right on the canvas via the same viewer used in Documents. See Canvas.

Claude Code

Session list. Click to open a session with chat on the left and project tree + file editor on the right. See Claude Code Sessions.

Discussions

Active shows running discussions with live turn updates. Runs is the history. See Discussion.

Voice

A full-height page with no header, built around the animated orb (the same one the mobile app uses). Top to bottom:

• Availability banner, shown only when there is something to say. An info tone means speech isn't configured, so voice is using your browser's own recognition and voice. A warning tone means a configured provider is failing its health checks, and the banner names it. A failing provider sitting next to a healthy active one shows no banner.
• Orb and live transcript — your words as they're recognized, then the reply.
• Prompt cards — when the agent needs an approval or asks a question, the prompt renders as a card right here and is read out (questions come with numbered choices). Answer out loud, by number, or by tapping. High- and Critical-risk approvals need you to say "yes, approve".
• Controls — settings, mic, and ✕ to leave voice. The hands-free toggle sits next to the mic and appears only when Conversation mode is turned on in Voice settings and hands-free can actually run.

Each visit starts a new chat session with the default agent unless the URL carries ?sessionId=. With a speech-to-text provider the mic is push-to-talk — click to talk, click again to send. With the browser recognizer there's no send step; the utterance ends at a pause. See Sophon Voice and Voice Surfaces.

Command Bridge

A full-screen live view of the fleet, with a hands-free voice bar along the bottom. The Bridge is hands-free only — there is no push-to-talk on it. Arm the bar with a press and it listens; each arm starts a new chat session with the default agent.

When nothing is left listening — the silence timeout, the inactivity limit, a microphone failure it can't retry, or a lost connection — the bar disarms itself and keeps the reason on screen instead of looking ready while nothing is listening. While an approval or question is waiting, the mic button's job changes to answer by voice, and a separate Stop voice control turns voice off without answering: the prompt stays on its chat card and its own timer keeps running.

Approvals

Queue of pending approvals. Each card shows tool, risk, params, preview, countdown. Approve / Edit / Reject. Resolved cards carry the outcome — Approved, Auto-approved, Rejected, Cancelled or Timed out. See Approval Gates.

Admin

• Users — create / delete / role assignment
• Roles — built-in + custom roles with granular permission matrix
• Audit — immutable action log, filterable, exportable
• License — paste license key, view tier, features, expiry
• Compliance — report generation, retention policies, export
• Tenants (Enterprise) — manage tenant workspaces

See Enterprise.

Operations

• System — health metrics, service status, resource usage
• Control — pause/resume agent processing, clear caches, diagnostics
• Remote Access — onboarding tickets for remote-device enrollment

Settings

Settings is split into per-topic pages:

• Overview — installation info, tier, quick stats
• Account — profile, preferences, data export
• Appearance — theme, accent, layout
• Models — LLM provider management, capability matrix with hidden-model toggles (Model Catalog)
• Connections — OAuth + API-key services (Connections)
• Webhooks — inbound + outbound (Webhooks)
• MCP — client connections + server hosting (MCP)
• Cron Jobs — scheduled tasks (Cron)
• Devices — Sophon Node pairings (Node). A paired device opens on its own detail page with tabs; admins also get a Voice tab on any node that reports voice commands, for the node's speech runtime settings and start / stop / interrupt controls. Non-admins never see it, because the routes behind it are Admin-only
• Execution — how Sophon runs multi-step work. Your personal default (Graph, Classic or the workspace default), plus an admin-only workspace panel for the Graph runtime. A conversation's own pill in the chat inspector beats your default, which beats the workspace default
• Voice — Voice Center: general voice preferences, conversation mode, TTS providers and voice selection, with a Listening section for speech-to-text providers and host defaults (Voice Providers)
• Notifications — push categories + quiet hours
• Terminal — in-browser CLI terminal (Pro/Enterprise)
• Tools — global tool registry view (admin)
• Plugins (admin) — enable the plugin system, hot start/stop individual plugins without a Gateway restart, and configure per-plugin settings (Plugins)
• Security — sessions, password, 2FA, and an Approvals tab that sets the host-wide plan-approval default (Approval Gates)
• Activity — login + API-key usage log
• Backup — create, monitor, and delete full data-directory backups; creation runs async with live progress. Requires the manage-settings permission, since backups contain every user's data
• Approved Senders — email allowlist

Routing

The Dashboard uses React Router. URLs are stable — you can bookmark any page. Session URLs like /chat/<session-id> are shareable within your team (other users see the same session only if they have access).

Keyboard shortcuts

Theming

Settings → Appearance. Choose:

• Dark / Light / System
• Accent color (6 presets + custom hex)
• Font size (compact / default / large)
• Layout density (cozy / compact)

Changes apply immediately without reload.

Real-time updates

Every live element — task status, chat streaming, approvals, notifications — comes through SignalR. If you see a "Reconnecting…" banner at the top, your SignalR connection dropped; the Dashboard reconnects with exponential backoff. Page reloads work if that ever gets stuck.

Where to go next

• Desktop App — Electron wrapper with tray and native keyboard shortcuts
• Mobile App — Sophon on iOS / Android
• CLI — scripted / headless access