Skip to content

Workspace

A workspace is your session container in Zelos. It maintains all your tabs, panels, connections, and settings, automatically persisting everything you need.

What a Workspace Contains

A workspace manages:

  • All tabs - Layout, extension, and settings tabs
  • Panel arrangements - Grid positions and configurations
  • Signal selections - Which signals are displayed and their settings
  • Mode state - Connection to live agent or loaded trace file
  • Timeline state - Current time position and zoom level
  • Sidebar state - Which sections are open and their contents

Automatic Persistence

Workspaces automatically save all changes to local storage. Your work is preserved across sessions and restarts.

Workspace Modes

Default Page

Default workspace overview.

Workspaces operate in two modes that determine available features:

Live Mode

Connected to a running agent for real-time data.

  • Real-time signal streaming from connected application
  • Live action execution on the agent
  • Dynamic signal discovery as data flows
  • Sliding time window (default: 30 seconds)

Connecting:

  1. Click "Connect Live" from welcome screen
  2. Default connects to localhost:2300
  3. Or enter custom address in Connections section (right sidebar)

Trace Mode

Analyzing previously recorded trace files.

  • Playback of recorded signals
  • Time-scrubbing through entire trace duration
  • No live actions (no agent available)
  • Actions section hidden in left sidebar

Opening a trace:

  1. Click "Open Trace" from welcome screen
  2. Select .trz file from file dialog
  3. Workspace switches to trace mode automatically

Quick Mode Switching

The Connections section in the right sidebar (Cmd+J / Ctrl+J) lets you quickly switch between connections or open different trace files.

Working with Tabs

Organize your workspace using tabs, similar to a web browser. Each workspace supports three types of tabs.

Tab Types

Layout Tabs

  • Main visualization tabs containing panels
  • Can have multiple layout tabs per workspace
  • Supports Plot, Table, Value, Log, Action, etc. panels
  • Can be renamed by double-clicking the tab name
  • Can be saved as reusable layouts

Extension Tabs

  • Display extension details
  • One tab per installed extension
  • Auto-opens when clicking an extension

Settings Tab

  • Global application settings
  • Only one settings tab per workspace

Tab Operations

Action Method Shortcut
New tab Click + button Cmd+T / Ctrl+T
Close tab Click × on tab Cmd+W / Ctrl+W
Rename Double-click tab name —
Reorder Drag tab left or right —
Switch Click tab or use number Cmd/Ctrl + 1-9
Next tab Cycle forward Cmd/Ctrl+Shift+] or Alt+Right
Previous tab Cycle backward Cmd/Ctrl+Shift+[ or Alt+Left

Additional Actions:

  • Middle-click to close a tab
  • Clear all tabs via ⋮ menu when multiple tabs exist
  • Tabs auto-scroll into view when switching

Tab Renaming

Only layout tabs can be renamed:

  1. Double-click the tab name to enter edit mode
  2. Type your new name (max 50 characters)
  3. Press Enter to save or Esc to cancel
  4. Click outside the input to save

Default names follow the pattern "Untitled 1", "Untitled 2", etc.

Workspace Lifecycle

Loading a Workspace:

  • Workspaces persist locally automatically
  • Connection state and trace files are restored
  • All tabs, panels, and settings are preserved

Recent Workspaces:

  • The welcome screen shows your recently accessed workspaces
  • Click any recent workspace to resume it
  • Recent list is automatically maintained

Keyboard Shortcuts

Tabs

Action Shortcut
New tab Cmd+T / Ctrl+T
Close tab Cmd+W / Ctrl+W
Switch to tab 1-9 Cmd/Ctrl + 1-9
Next tab Cmd/Ctrl+Shift+] or Alt+Right
Previous tab Cmd/Ctrl+Shift+[ or Alt+Left
Save rename Enter
Cancel rename Esc
Action Shortcut
Toggle left sidebar Cmd+B / Ctrl+B
Toggle right sidebar Cmd+J / Ctrl+J
Focus search Ctrl+F

Workspace

Action Shortcut
Close workspace Close last tab or use close button

Shortcut Availability

Keyboard shortcuts are disabled when typing in input fields or text areas.

Best Practices

Tab Organization:

  • Use descriptive tab names for layout tabs
  • Keep related visualizations in the same tab
  • Use separate tabs for different analysis views

Next Steps

  • Sidebars

    Browse signals, actions, extensions, layouts, and connections

  • Panels

    Create and configure data visualizations

  • Layouts

    Save and share panel arrangements

  • Timeline

    Navigate time and control playback