Run tasks in cloud
Cloud tasks run in remote cloud environments instead of on your machine. You can start them either from the JetBrains Air app or from https://air.jetbrains.cloud in a browser.
How cloud runs differ from local runs
In local runs, JetBrains Air changes files in your local working copy and does not commit them automatically (see details).
In cloud runs, JetBrains Air uses a remote environment with a limited lifetime. Although the environment remains available for some time after the task is done, there is always a chance that you will return after it is no longer available and will not be able to open it to review the changes there.
To avoid this risk, JetBrains Air commits the result to a separate task branch and pushes it to the remote repository. Because of this, the cloud workflow is slightly different: after the task is done, you review the result and then create a pull request from the pushed task branch.
Before you start
You can start with the default cloud environment, but for many projects it is useful to configure the environment first.
If you run tasks from the web UI, you must first configure a repository connection. Without it, you cannot select a repository in the browser. Learn how to connect repositories.
If your project needs specific dependencies, environment variables, secrets, or integrations, create an environment configuration for the repository in advance. Learn how to configure environments.
1. Run a cloud task
You can start a cloud task from the JetBrains Air app or from the web UI.
From the JetBrains Air app
Run a cloud task from the JetBrains Air app
Open your project in the JetBrains Air app.
Start creating a new task.
In the task run environment selector, choose Cloud.
Enter your task prompt and send the task.
From the web UI
Run a cloud task from the web UI
Log in to https://air.jetbrains.cloud with your JetBrains Account.
On the New Task page, select a repository and a branch.
Enter your task prompt and send the task.
After the task starts, it appears in the left pane.
2. Review the result
After the task is done, open it to review the result. JetBrains Air opens in your browser, so you can inspect the changed files, continue working with the agent, or ask the agent to review the recent changes.
Review a cloud task
Open the completed cloud task.
Review the changed files and the task conversation in the web version of JetBrains Air.
If you want the agent to review the recent changes, use
/reviewcommand (type/, start typingreview, and select Review with Agent).
In the quick actions list, select Git Commits.
Select the recent task commit and send the request.
If more work is needed, continue iterating in the same task: add extra context, leave comments in the code, and so on. Learn how to add context in Task context.
3. Apply the changes
After you review the result, apply the changes by creating a pull request from the task branch.
You can do this in either of the following ways:
in the cloud task itself (if the cloud environment still exists), by clicking Create PR
in your VCS provider, by opening the pushed task branch and creating a pull request there
Run cloud tasks from your IDE
You can start a cloud task from the AI Assistant in your IntelliJ-based IDE. This lets you stay in the IDE while the task runs in the cloud. You can monitor the task execution in JetBrains Air in the Tasks tool. You can also open your account page at air.jetbrains.cloud to see your running tasks.
Start a cloud task in the IntelliJ-based IDE
In your IntelliJ-based IDE (for example, IntelliJ IDEA), open AI Assistant and select JetBrains Cloud from the list of agents.
Type a task and click Send.
In JetBrains Air, open Tasks and select the task to track its state and progress.
Alternatively, open air.jetbrains.cloud to monitor your running tasks in the web interface.
