Quickstart with cloud agents
Cloud agents run tasks in remote cloud environments instead of on your machine. This is useful when you want to work from the web version of JetBrains Air, avoid setting up a project locally, run tasks in an isolated environment, or create automations that work without your machine being online.
Before you start
Make sure the following prerequisites are met:
You are signed in to your JetBrains Account.
You have access to the repository you want to work on with cloud agents, hosted in GitHub, GitLab, or Bitbucket.
For organization repositories – the the web version of JetBrains Air app is installed in your VCS provider for the organization that owns the repositories. Ask your organization administrator to install it – see app installation instructions.
For personal repositories – no prerequisites required – the app is installed for your personal account during onboarding.
1. Complete onboarding
The first time you open https://air.jetbrains.cloud, an onboarding wizard guides you through the initial setup: choosing an organization, connecting a VCS provider, authorizing access, and trying your first task.
After onboarding, the repositories you can access in the connected VCS provider become available in JetBrains Air, and you land on the new task page.
2. (Optional) Run a task
After onboarding, you can run a task at any time – either from the web or from the desktop app.
Run a cloud task from the browser
In the new task form, select a repository.
Select a branch.
Enter your task prompt and click Send.
Wait while JetBrains Air creates the cloud environment and starts the task.
The task appears in the left panel in the Running state.
Click the task to open the JetBrains Air editor right in the browser.
After the task starts, you work with it the same way as with other JetBrains Air tasks: review changes, iterate on the result, and decide whether to accept the changes.
Run a cloud task from the desktop app
Open your project in JetBrains Air.
Start creating a new task.
In the task header, click the run environment selector and choose Cloud.
Enter your task prompt and send it.
Wait while JetBrains Air prepares the cloud environment and opens the task session.
Review the running task in the same familiar JetBrains Air interface.
3. (Optional) Connect other VCS providers
During onboarding, you connect one VCS provider. To work with repositories hosted in another provider, connect it from .
Connect another VCS provider
In the web version of JetBrains Air, click
Settings in the left panel, then open the Integrations section.
Click Connect next to the VCS provider you want to add.
Complete the authorization flow in the provider UI and grant access to the required repositories (personal or organizational).
Return to JetBrains Air and verify that the provider is shown as connected.
For full details, including how to grant access to organization repositories, see Connect repositories.
4. (Optional) Create an environment configuration
For many projects, the default cloud environment is enough, and you can skip this step.
Create an environment configuration if your project needs additional setup, for example:
environment variables
personal secrets such as API tokens
a specific VM size
restricted or expanded internet access
Environment configurations are created per repository in . If no configuration exists, JetBrains Air uses the default one.
Create an environment configuration
Open the web version of JetBrains Air at https://air.jetbrains.cloud.
In the left panel, click
Settings. Then open the Environments section.Click New Configuration.
Adjust the configuration:
Select the repository that the configuration will apply to.
Choose the VM size and internet access mode.
Add environment variables and personal secrets if your project requires them.
Click Save.
For full details, see Configure environments.