Choose where Qoder reads files, runs commands, and records changes.
Choose the workspace and execution environment before sending the task. The selection determines where Qoder reads files, runs commands, and inspects Git state.
Select an existing workspace or choose New workspace. A workspace can contain multiple readable and writable project folders, with one primary folder used for opening the project.
Worktree tasks isolate changes in a separate Git checkout. Configure retention and backup behavior under Settings → Worktrees. Ignored files are not included in the Git backup, so do not rely on the backup for generated secrets or local-only data.
Choose Connect SSH or add a host under Settings → Connections. Qoder reads hosts from
| Environment | Where changes are made | Use it when |
|---|---|---|
| Local workspace | The open project directory on this device | You need a small change, fast verification, or immediate access to the result. |
| Worktree | A separate Git worktree | You are running parallel tasks or isolating a larger change from the current checkout. |
| SSH workspace | A directory on a registered remote host | The code, dependencies, or runtime exist only on that host. |
| No workspace | No project directory | The task does not need project files or commands. |
Local workspace
Select an existing workspace or choose New workspace. A workspace can contain multiple readable and writable project folders, with one primary folder used for opening the project.
Worktree
Worktree tasks isolate changes in a separate Git checkout. Configure retention and backup behavior under Settings → Worktrees. Ignored files are not included in the Git backup, so do not rely on the backup for generated secrets or local-only data.
Start a Worktree task
- Open the current execution mode at the bottom of the task composer.
- Select Worktree, then choose the Git branch to use as the starting point.
- If Qoder offers to include uncommitted changes, review them before enabling the option.
- Send the task. Qoder reads, edits, and verifies the code in the separate worktree.
SSH workspace
Choose Connect SSH or add a host under Settings → Connections. Qoder reads hosts from ~/.ssh/config; the selected remote directory must be writable by the SSH account.
Choosing safely
- The project must be a Git repository for Worktree to appear.
- Each worktree uses disk space; remove unused worktrees under Settings → Worktrees.
- SSH commands and file operations run on the remote host. Confirm the host, directory, and branch before sending.
- Environment isolation does not replace permission controls. Choose an appropriate Access Permissions option for the task.
An existing task cannot switch between Local and Worktree modes. Create a new task when the execution boundary must change.