Skip to main content
Environment and Execution

Execution environments

Choose where Qoder CN reads files, runs commands, and records changes.

Choose the workspace and execution environment before sending the task.
EnvironmentWhere changes are madeUse it when
Local workspaceThe open project directory on this deviceYou need a small change, fast verification, or immediate access to the result.
WorktreeA separate Git worktreeYou are running parallel tasks or isolating a larger change from the current checkout.
SSH workspaceA directory on a registered remote hostThe code, dependencies, or runtime exist only on that host.
No workspaceNo project directoryThe task does not need project files or commands.

Local workspace

Select an existing workspace or New workspace. A workspace can contain multiple readable and writable project folders and one primary folder used to open the project.

Worktree

Worktree tasks isolate changes in a separate Git checkout. Configure retention and backup under Settings → Worktrees. Ignored files are not included in the Git backup.
  1. Open the execution mode at the bottom of the task composer.
  2. Select Worktree, then choose the starting Git branch.
  3. Review any option to include uncommitted changes before enabling it.
  4. Send the task. Qoder CN reads, edits, and verifies code in the separate worktree.
Review changes before bringing them back to the local workspace. Keep the local workspace clean before a handoff.

SSH workspace

Choose Connect SSH or add a host under Settings → Connections. Qoder CN reads hosts from ~/.ssh/config; the selected 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.
  • Confirm the SSH host, directory, and branch before sending.
  • 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.