Overview
Workspaces represent repository roots in ctx.
A workspace is the boundary for settings, tasks, sessions, and review context.
Workspace lifecycle
- Add workspace
- Open workspace
- Configure baseline settings
- Run tasks and sessions
- Clean up stale entries when no longer needed
Good workspace hygiene
- Add only true repo roots.
- Keep workspace names clear when managing multiple repos.
- Remove stale workspace entries you no longer use.
Common pitfall
If behavior looks wrong, first verify you are in the expected workspace.
Many review and session issues are just "wrong workspace" mistakes.