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 Notetaker 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:

• Notetaker: the default view when you open a Space. Shows detected meeting topics with coverage status and a badge count for topics with new information. Notetaker Docs are managed within this view. See Notetaker for details.
• Meeting: expandable sub-sections:
  • People: active participants with mic/camera status
  • Transcript: live and historical transcription
  • Notes: editable meeting notes (auto-created markdown file)
• Running Apps: web servers started by the agent, with URLs and ports
• Plugins: widget plugins from _stoa_plugins/ rendered as accordion sections

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

In a Project workspace:

• Files: project file tree
• CLI Connection: remote URL for CLI access

Right Sidebar

Toggle with ].

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:

• Add to Notetaker / Remove from Notetaker for flagging documentation 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 Notetaker Docs, Meeting, Transcript, Files, or Recent Edits

Actions

• Create new file
• Start the AI agent
• Switch project (G P)
• Search meetings (/)
• Go back / Go forward (G [ / G ])
• 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.

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

Watch

What's Next