What a workspace is#

A workspace is an isolated working copy for one task. It gives an agent a place to edit files without mixing its changes into another task.

Create one#

• Pick a repository.
• Choose a base branch or target branch.
• Create a new workspace for the task.
• Open the session panel and start the conversation.

When to create a new workspace#

Use a new workspace when the task should have its own branch, review surface, or commit history. This keeps unrelated agent work separated and easier to inspect.

Good workspace habits#

• Keep one task per workspace.
• Use a clear branch name when possible.
• Review the diff before committing or opening a pull request.