Definition#

A workspace is the working copy where an agent performs one task. It usually maps to a branch or worktree and contains the files, sessions, and changes for that task.

Why it matters#

Workspaces keep agent work isolated. You can run multiple efforts in parallel, inspect each diff separately, and decide which changes are ready to commit.

What you see in a workspace#

• Current branch and target branch information.
• Sessions attached to the task.
• File changes and review state.
• Actions for continuing, committing, archiving, or shipping work.

Good use#

Create a workspace for a focused goal. If a task turns into a different problem, create another workspace instead of mixing the work.