Skip to main content
Workspaces interface showing the four-panel layout with labels for each section
The Workspaces UI uses a flexible four-panel layout designed for efficient AI-assisted development workflows.

​
Panel Overview

The navbar at the top of the workspace provides quick access to common actions.

​
Left Section

​
Right Section - Panel Controls

​
Right Section - Utilities

When the Changes panel is open, additional diff controls appear for toggling between side-by-side and inline views.

​
Workspace Sidebar

Workspace sidebar in flat list layout showing workspaces with timestamps and change counts
The left sidebar displays all your workspaces at a glance. Switch to accordion layout to group workspaces by status:
Workspace sidebar in accordion layout grouped by Needs Attention, Idle, and Running

​
Status Indicators

Each workspace shows its current state:

​
Workspace Actions

  • Search: Filter workspaces by name or branch
  • Pin: Keep important workspaces at the top
  • Archive: Move completed workspaces out of the main list
  • Layout toggle: Switch between flat list and accordion (grouped by status)

​
Creating a New Workspace

Create Workspace view showing project selection, repositories panel, and task description input
Click the + button at the top of the sidebar to create a new workspace. The interface switches to create mode:
  1. Select a project from the Project dropdown in the right sidebar
  2. Add repositories - click repos from the “Add Repositories” list or browse for repos on disk
  3. Set target branch - each selected repo shows its target branch (click to change)
  4. Describe your task in the chat input at the bottom
  5. Select an agent (e.g., Claude Code) and variant
  6. Click Create to start the workspace
For detailed instructions, see Creating Workspaces and Repositories.

​
Conversation Panel

Conversation panel showing chat history with coding agent and session switcher
The left main panel is where you interact with coding agents.

​
Chat Interface

  • View the full conversation history with the agent
  • Send messages and follow-up instructions
  • Rich text support for formatting
  • Approval workflows for reviewing agent plans
  • Agent and variant selection
See Chat Interface for the complete guide.

​
Session Dropdown

The chat box toolbar includes a session dropdown that lets you:
  • View all sessions in the workspace
  • Switch between sessions (shows “Latest” or timestamp)
  • Create a new session by selecting “New Session”
Create multiple sessions to work around conversation token limits or to run different agents in parallel.
See Sessions for more details on managing multiple sessions.

​
Chat Shortcuts

​
Context Panel

The right main panel toggles between three views:

​
Changes View

Changes panel showing file tree and diff viewer with code changes
Displays all modified files with inline diffs:
  • File tree: Hierarchical view of changed files
  • Search: Filter files by name
  • Diff viewer: See code changes with syntax highlighting
  • Comments: Add inline comments for agent feedback

​
Logs View

Logs panel showing process output with tabs for different processes
Shows process execution logs:
  • Process tabs: Switch between different running processes
  • Log output: View stdout/stderr in real-time
  • Search logs: Filter log content

​
Preview View

Preview panel showing built-in browser with dev server output
Built-in browser for testing your application:
  • Dev server tabs: Multiple dev servers supported
  • Device modes: Desktop, mobile, custom viewport
  • Process logs: View dev server output
Toggle between views using the navbar buttons or the command bar.

​
Details Sidebar

The right sidebar provides quick access to workspace details.

​
Git Section

Git section showing repository, branch, and pull request options
Always visible, showing:
  • Current repository and branch
  • Target branch for merging
  • Uncommitted changes count
  • Commits ahead/behind target
  • Quick access to git operations
See Repositories for details on managing repositories and branches.

​
Terminal Section

Integrated terminal in the details sidebar showing command output
The integrated terminal is a new feature exclusive to the Workspaces UI and is not available in the classic interface.
The expandable terminal lets you run commands directly in your workspace:
  • Full terminal emulation powered by xterm.js
  • Run any command - git, npm, build scripts, etc.
  • Persistent state - terminal persists across panel toggles
  • Expandable - collapse when not needed, expand when you need it

​
Notes Section

Notes section in the details sidebar showing rich text editor with workspace notes
Workspace notes are a new feature exclusive to the Workspaces UI and are not available in the classic interface.
The expandable notes section lets you document important information:
  • Auto-save - Notes save automatically as you type
  • Per-workspace - Each workspace has its own notes
  • Persistent - Notes are preserved across sessions

​
Context Bar

Context bar floating toolbar showing quick action buttons
A floating toolbar that provides quick access to common actions:
The context bar is draggable - position it wherever works best for your workflow.

​
Resizing Panels

Drag the separators between panels to adjust their proportions. Your layout preferences are saved per workspace.

​
Toggling Panels

Show or hide panels to focus on what matters:
  • Use the navbar toggle buttons
  • Use the command bar with Cmd/Ctrl + K
  • View Options commands let you toggle any panel
Panel states are remembered, so your preferred layout is restored when you return to a workspace.