Multi-Workspace

Multi-workspace allows you to simultaneously open and manage multiple project workspaces, freely switch between local and remote workspaces, and maintain independent sessions and configurations for each workspace.

Overview

Core capabilities of the multi-workspace feature:

• Multi-workspace parallel: Open multiple local or remote project folders simultaneously
• Workspace tabs: Quickly switch workspaces via the top tab bar
• Remote access: Access folders on other computers via tunnels
• Session isolation: Each workspace has its own independent chat session history
• Independent configuration: Each workspace can have its own rules, models, MCP tools, etc.

Workspace Types

Type	Description	Identifier
Local Workspace	Project folder on your local machine	local:<path>
Remote Workspace	Project folder on a remote computer	remote:<machine_id>:<path>
Default Workspace	Main workspace auto-created on first launch (.codely/default)	Displayed as "Default"

UI display:

• Top workspace tab bar
• Left workspace sidebar (with session history)
• Workspace selection menu

---

Workspace Interface

Workspace Tab Bar

Located at the top of the interface, displaying all open workspaces as horizontal tabs:

• Default workspace is always on the far left (if it exists)
• The currently active workspace is highlighted
• Tab names that are too long show an ellipsis; hovering displays the full path
• When there are too many tabs, it automatically switches to a dropdown menu mode

Tab Bar Interactions:

• Click a tab to switch to the corresponding workspace
• In dropdown menu mode, the current workspace shows a ✓ mark
• The tab bar auto-scrolls to the currently active tab

Workspace Sidebar

The left sidebar displays all workspaces and their session history:

• Each workspace is a collapsible section
• Section title shows workspace name and status
• When a workspace is loading, a spinning animation and "Core loading..." message are displayed
• Sessions are grouped by status: Pinned → Active → Archived

---

Managing Workspaces

Open a Local Workspace

1. Click the "Open Workspace" button at the top of the sidebar
2. In the workspace menu that appears:
   • Recent Projects: Shows recently opened projects, click to open
   • This Computer: Browse local folders
3. Click "Open Folder" to select a local directory
4. After selecting a directory, the new workspace is automatically added to the tab bar and sidebar

Open a Remote Workspace

1. Click the "Open Workspace" button at the top of the sidebar
2. Click "Open Remote Folder"
3. In the remote folder dialog:
   • Left panel: Select the remote computer
   • Right panel: Browse folders on that computer
4. Navigate to the target folder and click "Open"

Remote Folder Dialog Features:

• Multi-drive support (Windows C:, D:, etc.)
• Breadcrumb navigation for quick access to parent directories
• Folder filtering for quick targeting
• Separate prompts for network errors and server errors

Switch Workspaces

There are three ways to switch workspaces:

1. Tab bar: Click the top workspace tab
2. Sidebar: Click a session under the target workspace on the left
3. Workspace menu: Select from the top dropdown menu

When switching workspaces:

• The current workspace's session state is automatically saved
• The target workspace's core engine readiness is automatically checked
• If the target workspace has no active session, a new one is automatically created

Remove a Workspace from Sidebar

1. Click the ⋯ menu on the right side of the workspace section title
2. Select "Remove from Sidebar"
3. The workspace is removed from the tab bar and sidebar

• If the removed workspace is the currently active one, the system automatically switches to the next available workspace

---

Remote Access Setup

Before using remote workspaces, you need to enable remote access on the computer being controlled.

Controlled End (the computer being accessed) Setup

1. Open Settings → Devices
2. Enable "Allow others to control my computer"
   • Only devices under the same Codely account can access
3. (Recommended) Enable "Keep computer awake"
   • Prevents the computer from sleeping, which would block remote access

Controller End (the computer accessing remotely)

1. Make sure both computers are logged into the same Codely account
2. In the sidebar, click "Open Workspace" → "Open Remote Folder"
3. The remote computer list auto-discovers (shows "Discovering remote machines...")
4. Select the remote computer, browse and open a folder

First-time Setup Guide

If the remote computer list is empty, the dialog shows a three-step guide:

1. On the computer you want to control, go to Settings → Devices
2. Turn on "Allow others to control my computer"
3. On the controller end, open "Open Remote Folder" to access the controlled end's files

---

Workspace Action Menu

Click the ⋯ button on the right side of the workspace section title to perform the following actions:

Action	Description	Remote Workspace
Show in Folder	Open workspace directory in system file manager	✗
Open Terminal	Open terminal in workspace directory	✓
Open Editor	Open project in Unity Editor (Unity projects only)	✓
Mark All as Read	Mark all sessions in the workspace as read	✓
Remove from Sidebar	Remove workspace from sidebar and tab bar	✓

---

FAQ

Workspace shows "Core loading..."

Cause: The workspace's backend core engine is not yet ready. The system automatically polls to check readiness.

Solution: Wait a few seconds; the core engine usually finishes loading shortly.

Remote computer list is empty

Cause: The controlled end hasn't enabled remote access, or the two computers aren't logged into the same Codely account.

Solution:

1. Confirm the controlled end has enabled "Allow others to control my computer"
2. Confirm both computers are logged into the same Codely account
3. Click the "Refresh" button in the dialog to rediscover

Remote folder cannot load

Cause: Network connection issue or Codely service abnormality on the remote computer.

Solution:

• If prompted "Unable to load remote computer, please check network connection" — check your local network
• If prompted "Something went wrong, please retry" — check if Codely is running normally on the remote computer
• Click the "Retry" button to reconnect

Workspace tab bar becomes a dropdown menu

Cause: Too many workspaces are open for tabs to fully display in one row at the top.

Solution: This is normal adaptive behavior. Close unneeded workspaces to restore tab mode.

Workspace Display Names

• Local workspaces display the folder name (e.g., my-project)
• Remote workspaces display "Folder Name (Machine Name)" format
• Default workspace displays as "Default"