Execution environments
Each task runs in an execution environment. Select the environment in the task header before you start the task.
Select an execution environment
In the task header, click the environment name.
JetBrains Air supports three execution environments:
Select the execution environment:
Git Worktree: creates a separate working branch of the repository. This mode provides isolation from your main branch while still using your local environment. Note that you may need to reinstall project dependencies or repeat location-specific setup for every new task.
Docker: runs in an isolated container. You must have Docker Desktop installed and a valid license to use it. This mode offers complete isolation for code changes and tools. Isolation means that all edits, commands, and dependencies stay inside the container and do not affect your local workspace or system environment.
Local Workspace: runs directly in your current workspace. This mode has the fastest startup and uses your existing environment, but changes are applied to your project folder. It does not provide isolation.
Local Workspace
Use Local Workspace to run a task on your machine in the current workspace. This option starts fast and uses your existing local setup. Changes apply to your working copy.
Git Worktree
Use Git Worktree to run a task in a separate working copy of the same repository. This option helps you isolate changes from your main working directory. Use it when you want to work on multiple tasks without mixing edits. For more information about Git worktrees, refer to git-worktree at git-scm.com.
For each task, JetBrains Air creates a separate branch in the worktree.
When the task is finished, you can bring the changes back to your local branch:
If you click Apply Locally, JetBrains Air copies the uncommitted changes from the task branch to your local branch.
If you click Checkout Branch Locally, JetBrains Air creates a new local branch and adds a commit with the message Auto-committed changes. You can merge the branch into your local branch later, or push it to the remote repository.
Docker
Use Docker to run a task in an isolated container. This option helps you sandbox tools and dependencies. Use it when you want isolation from your local environment.
For each task, JetBrains Air creates a separate branch inside the container.
When the task is finished, you can bring the changes back to your local branch:
If you click Apply Locally, JetBrains Air copies the uncommitted changes from the task branch to your local branch.
If you click Checkout Branch Locally, JetBrains Air creates a new local branch and adds a commit with the message Auto-committed changes. You can merge the branch into your local branch later, or push it to the remote repository.