Symptoms#
A workspace fails to create, open, archive, delete, or show expected file changes.
First checks#
- Confirm the source repository path still exists.
- Check that the target branch or base branch is valid.
- Make sure another Git worktree is not already holding the same branch.
- Inspect the working tree for uncommitted or conflicting state.
Common causes#
Workspace errors often come from missing repositories, branch conflicts, deleted local files, Git permission problems, or interrupted setup steps.
Recovery#
If the workspace has valuable changes, inspect the folder before deleting anything. If it has no useful changes, create a new workspace from a clean branch and retry the task.