Workspace

The workspace is where you will spend most of your time in Stoa. It puts your files/code editor, video call, AI agent, and decisions sidebar into one view. You can rearrange the layout to match what you're doing: full-screen video when you're talking, full-screen code when you're building, or a split when you're doing both.

Layout Modes

The workspace has three layout modes. Switch between them using chord shortcuts or the command palette. Video and Split layouts are only available while you're in a call.

In Split mode, you can dock the video panel to the right, top, or bottom of the workspace.

Sidebars

The workspace has two collapsible sidebars:

Left Sidebar

Toggle with [ or Cmd+B.

The left sidebar uses a VS Code-style accordion layout with resizable, collapsible sections. You can drag the dividers between sections to resize them, and your sizes are saved per workspace.

In a Space workspace, three top-level sections are available:

Space section:

• Decision Topics: the default view when you open a Space. Shows detected meeting topics with coverage status and a badge count for topics with new information. See Decision Topics below.
• Meeting Context: files flagged as relevant to the current session. Each session starts with a clean slate. See Meeting Context below.
• Meeting: expandable sub-sections:
  • People: active participants with mic/camera status
  • Transcript: live and historical transcription
  • Chat: in-session text messages
  • Notes: editable meeting notes (auto-created markdown file)
  • Recordings: session recordings (when enabled)

Project section:

• Files: project file tree with VS Code-style icons. Supports drag-and-drop file moves, context menus with Copy Link, Copy Path, and Delete Folder, and a collapse/expand all toggle.
• Your Recent Edits: shows files you've recently edited in the current Space, replacing the older bookmarks feature at the space level
• Bookmarks: saved files and prompt templates

In a Project workspace:

• Files: project file tree
• Bookmarks: saved files and prompts
• CLI Connection: remote URL for CLI access

Right Sidebar

Toggle with ] or Cmd+Shift+B.

The right sidebar houses the AI Agent panel. See AI Agent for details.

File Management

The file pane supports several ways to organize your project:

Drag and Drop

Drag files and folders within the file tree to move them. Drop onto a folder to move the item inside it, or drop onto the root area to move it to the project root. Visual feedback shows the drop target as you drag.

Context Menu

Right-click any file or folder to access:

• Flag as Meeting Context / Remove Meeting Context for session-scoped files
• Copy Link to get a shareable workspace URL
• Copy Path to copy the full file path
• Rename, Cut, and Delete
• For folders: New File, Paste, and Delete Folder (with confirmation showing file count)

Merge Modal

When you move a folder into a location that already has a folder with the same name, a merge modal appears. It lists each conflicting file with Replace or Skip toggles, so you can choose exactly what happens per file.

Collapse/Expand All

The file pane header includes a toggle to collapse or expand all folders at once, plus a refresh button and file count display.

Navigation Ribbon

When inside a team context, a persistent navigation ribbon appears on the left edge:

The ribbon can be expanded (~220px) or collapsed (~52px) using the toggle at the bottom.

Live Session Indicators

Spaces with active sessions show a green dot, participant count, and participant names directly in the navigation ribbon, so you can see at a glance where your team is and who's in each session.

Command Palette

Press Cmd+K (or Ctrl+K) to open the command palette. It works even when you're focused on an editable field.

Available actions:

Navigate

• Search and open files in the current project
• Switch between projects in a Space

Layout

• Switch to Video / Split / Project mode
• Toggle left sidebar
• Toggle agent sidebar

Sidebar

• Jump to Decisions, Decision Topics, Meeting Context, Meeting, Transcript, Recordings, Files, or Bookmarks

Actions

• Create new file
• Start the AI agent
• Switch project
• Voice to agent (push-to-talk, when available)

Each action shows its chord shortcut for reference, so the command palette doubles as a keyboard shortcut cheat sheet.

Decision Topics

During a meeting, the AI monitors your conversation and detects high-level topics being discussed. Think of these as chapter headings for your meeting: typically 3 to 7 per hour-long session, not granular decisions.

How it works

1. Every 90 seconds, the system analyzes new transcript segments and detects topic shifts.
2. For each topic, it writes structured meeting notes with labeled items: Intent, Decision, Implementation, Idea, and Open Question.
3. A coverage checker compares the detected topics against your Meeting Context files to determine whether each topic contains new information.
4. Known participant names are passed to the topic writer so notes can attribute statements to specific people.

Topic cards

Topics appear as collapsible cards in the sidebar. New topics are expanded by default, while older ones are collapsed to keep the view manageable. Each card shows the topic name, a summary, and a status badge dropdown for changing status.

Topic names and summaries are editable inline. Click the text to edit, then click away or press Enter to save.

The sidebar badge updates in real time via LiveKit data channel events, so you see new topics appear instantly without any polling delay.

Topic status

Each topic has a coverage status:

You can change the status from the dropdown on each topic card.

Applying a topic

When a topic has new information, click Apply to send it to the AI agent. This builds a prompt with references to your meeting notes and context files, loads it into the agent composer as a draft, and lets you review before sending. The agent then reads the files and updates them with the new information.

Meeting Context

Meeting Context replaces the older "Team Context" concept. The key difference: context files are now scoped to a single session, not shared across all sessions in a Space. Each meeting starts with a clean slate.

Flag any file as meeting context using the file tree context menu or the Meeting Context section. These flagged files are used by the coverage checker to determine whether discussion topics have already been captured in your project documentation.

Files are automatically flagged as meeting context when you edit them during a meeting. Simply opening a file won't flag it. If you remove a file from meeting context during a session, it won't be automatically re-added even if you edit it again.

File paths shown in the Meeting Context section and in topics are clickable, so you can jump directly to the relevant file.

This prevents context from one meeting bleeding into an unrelated meeting later.

Command mode

When you're editing a file, workspace shortcuts (like chord shortcuts) are disabled to avoid interfering with typing. Press Escape to exit the editor and enter command mode, which re-enables all workspace shortcuts.

Mobile Support

On mobile devices:

• The left sidebar opens as a full-screen overlay
• The navigation ribbon is hidden (accessed via menu)
• On tablets, the sidebar auto-collapses to save screen space
• Swipe gestures are supported for opening/closing panels

What's Next