Workspace Settings

Manage workspaces for organizing your projects and conversations.

What Are Workspaces?

Workspaces are directory-based contexts that help organize your conversations around specific projects or folders. When you set a workspace, the AI gains context about files in that directory.

Managing Workspaces

Adding a Workspace

1. Click Add Workspace
2. Select a directory from your file system
3. The workspace appears in your list

Setting a Default Workspace

Click the star icon on any workspace to set it as default. The default workspace is automatically selected for new conversations.

Click the star again to clear the default.

Editing a Workspace

1. Click the edit (pencil) icon
2. Change the workspace name
3. Press Enter or click the checkmark to save

Deleting a Workspace

1. Click the delete (trash) icon
2. Confirm the deletion

WARNING

You cannot delete the default workspace. Clear the default first, then delete.

You cannot delete a workspace that has associated chat threads.

Opening in Finder/Explorer

Click the folder icon to open the workspace directory in your system's file manager.

Temporary Workspaces

Temporary workspaces are created automatically when you open files from directories not in your workspace list.

Show Temporary Workspaces

Toggle this option to see temporary workspaces in the list.

Show in List

For temporary workspaces, you can toggle whether they appear in the workspace selector dropdown.

Workspace Context

When a workspace is active:

• The AI can reference files in that directory
• File paths are relative to the workspace root
• Tools like file search are scoped to the workspace

TIP

Set up workspaces for your main projects to keep conversations organized and give the AI relevant context.