Interface Overview

Layout

SoAgents uses a multi-tab layout with three main areas:

  • Left Sidebar — Session list, workspace switcher, feature shortcuts
  • Center Area — Chat window or file editor
  • Top Bar — Tab management, model switching

The sidebar provides quick access to:

  • Session List — All conversations, with pinning, archiving, and search
  • New Chat — Create sessions in the current workspace or globally
  • Workspaces — Switch between project directories
  • Settings — Provider, MCP, and skill configuration
  • Scheduled Tasks — View and manage automation
  • Task Center — Monitor long-running jobs

Tab Types

SoAgents supports multiple tab types:

  • Chat Tabs — Independent AI conversation sessions
  • File Tabs — Built-in code editor with syntax highlighting
  • Settings Tab — Configure providers, MCP, skills
  • Task Tabs — Scheduled tasks and task center

Tabs support drag-and-drop reordering and persist across restarts.

Chat Interface

Key elements in the chat area:

  • Message Stream — Real-time streaming of AI responses
  • Tool Calls — Color-coded badges showing AI tool usage (file reads, commands, etc.)
  • Input Box — Multiline input, image paste, file drag-and-drop
  • Workspace Selector — Switch working directory mid-conversation
  • Token Stats — Per-message token consumption display