Skip to content
Scion

Web Dashboard

The Scion Web Dashboard provides a visual interface for managing your agents, projects, and runtime brokers. It complements the CLI by providing real-time status updates and easier management of complex environments.

Overview

Section titled “Overview”

The dashboard is organized into several key areas:

Dashboard Home

Section titled “Dashboard Home”

The landing page provides an overview of your active agents across all projects and the status of your runtime brokers.

Notifications & Alerts

Section titled “Notifications & Alerts”

The dashboard features an integrated notification framework with real-time SSE delivery.

  • Inbox Tray: A dedicated tray accessible from the top navigation, providing a centralized view of all persistent messages sent by your agents. It features unread message badges and mark-as-read actions to help you track items requiring human input.
  • Notification Tray: Provides agent-scoped filtering for status events, accessible directly from the top navigation.
  • Browser Push Notifications: Opt-in native browser push notifications ensure you receive alerts even when the dashboard is in the background. Default triggers include stalled and error states, as well as requests for user input.

Projects

Section titled “Projects”

View and manage your registered projects.

  • Create/Register Project: Create a Hub-Native workspace directly on the Hub, or connect a new remote Git repository. Includes a confirmation dialog when creating a project for an existing git repository.
  • Project Settings: Centralized configuration interface for managing project-scoped environment variables and secrets, including “Injection Mode” controls (Always vs. As-Needed). The settings page features a streamlined flow with a “Done” button and hides unnecessary registration options for git-backed projects.
  • Workspace & File Management: Access the comprehensive inline file editor to view and modify files directly in the browser, featuring integrated Markdown preview capabilities. The file browser supports fuzzy and regex-based filtering for fast navigation. You can also download individual workspace files or generate ZIP archives of entire projects directly from the UI.
  • Template Management: Direct server-side importing of templates with immediate UI feedback. Includes full template file browsing, editing, and upload capabilities directly within the dashboard.
  • Shared Directory Management: View and manage project shared directories directly from the Web UI (see Project Shared Directories).
  • Agent List: See all agents belonging to the project, with card/list view toggle for flexible display.

Agents

Section titled “Agents”

Detailed view for individual agents, featuring a high-density tabbed layout and improved breadcrumb navigation with a dedicated back button.

  • Advanced Agent Creation: A comprehensive form for Just-In-Time (JIT) configuration, allowing granular control over models, resource limits (max_turns, max_duration), and harness settings at creation time. It features a native Runtime Profile Selector that dynamically populates available profiles based on the selected broker, and Custom Branch Targeting, which allows users to direct agents to clone and check out specific git branches immediately upon creation.
  • Status Tab: Real-time view of agent lifecycle (Starting, Thinking, Waiting, etc.). Includes stalled agent detection to flag agents that have stopped responding (setting their activity status to offline).
  • Logs Tab: Streamed logs from the agent container via the integrated Cloud Log Viewer.
  • Messages Tab: A dedicated tab for viewing structured messages sent to and from the agent.
  • Configuration Tab: Dedicated tab for viewing the applied configuration of the agent, featuring a new telemetry configuration card.
  • Debug Panel: A full-height panel providing a real-time stream of SSE events and internal state transitions for advanced troubleshooting and observability.
  • Terminal: Interactive terminal access to the agent’s workspace, featuring full Tmux support. Includes a dedicated terminal toolbar, seamless window switching (agent/shell), automatic window size adjustment, extended key sequence support (like Shift+Enter), and modifier-based text selection (Shift-drag or Option-drag on macOS). For detailed configuration, see Interactive Sessions with Tmux.
  • Workspace Content Previews: Content preview capabilities for workspace files directly within the UI, allowing you to quickly inspect agent output and project data.
  • Lifecycle Control: Start, stop, restart, or delete agents from the UI. Includes bulk operations like the “Stop All” button for efficient bulk shutdown of all agents within a project.

Runtime Brokers

Section titled “Runtime Brokers”

Monitor the infrastructure nodes where your agents are executing.

  • Status: See which brokers are online and their current load.
  • Configuration: View broker capabilities (Docker, K8s, etc.).

Admin Management Suite

Section titled “Admin Management Suite”

Centralized views for managing the Scion infrastructure and access control (available to administrative users).

  • Users: View and manage user accounts and roles.
  • Groups: Create and manage organizational groups for policy-based authorization.
  • Service Accounts: Manage and validate registered Google Service Accounts for use with the metadata emulation pipeline.
  • Brokers: Comprehensive broker detail pages providing a grouped view of all active agents by their respective projects.
  • Maintenance Mode: Toggle maintenance mode for the Hub and Web servers to facilitate safe infrastructure updates.

Authentication

Section titled “Authentication”

The dashboard supports several authentication methods:

  • OAuth (Google/GitHub): For standard user access.
  • Development Auto-login: For local development.

See the Authentication Guide for setup instructions.

API Proxying

Section titled “API Proxying”

The Go server handles API proxying, token injection, and session management so the browser never handles raw API keys or long-lived tokens directly.