Skip to main content
A workspace is the repository root ctx operates on.

Add a workspace

  1. Open the workspace list in the app.
  2. Add your repository root.
  3. Open the workspace.
  4. Create your first task.

Workspace setup sanity checks

  • The workspace path is correct.
  • You can create a task from that workspace.
  • Session runs can start.
  • Diff review works after a session edits files.

Team convention

Use one workspace per repository root. Avoid adding nested project folders as separate workspaces unless you have a specific reason.