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 (Preview)
• Voice — voice interaction surface
• 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 mode toggle
• 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
• 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 (Preview).

Voice

Full-screen voice surface with the animated orb (same one used in the mobile app). Hands-free mode toggles via the Dashboard mic button or a system-wide keyboard shortcut (Electron only). The Listening tab shows live transcripts as you speak plus the current STT provider status, and Voice Center holds per-user listening overrides (Voice).

Approvals

Queue of pending approvals. Each card shows tool, risk, params, preview, countdown. Approve / Edit / Reject. 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

18 pages under Settings:

• 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)
• Voice — TTS provider + voice selection, Listening tab for STT providers and host defaults (Voice)
• 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