Cloud agents
Cloud agents are coding agents that run in an isolated cloud environment instead of on your machine. You can use them to offload long-running or resource-heavy work: the agent runs remotely while you keep working in your IDE, and it writes its results to a separate branch that you can review and merge.
Prerequisites
Before you can run agents in the cloud, make sure the following requirements are met:
An organization administrator has enabled AI for the organization or for individual users in JetBrains Central Console.
You're logged in to the IDE with your organizational account. This automatically signs you in to JetBrains Central and selects a workspace for you.
The agents you want to run in the cloud are installed from the agent registry.
Run an agent in the cloud
To run an agent in the cloud:
In AI Chat, open the agent selector and choose the agent you want to use.
If the agent supports remote runs, a panel with a switcher for running it in the cloud appears. Switch to Cloud mode.
Click the branch selector and choose the remote branch the agent works on. Use the Search remote branch field to filter the list.
Select a model to process your requests by clicking
and selecting from the list.Write a prompt describing the task and submit it.
The first time you run a cloud agent, you might be prompted to authorize the JetBrains Air GitHub App so the agent can access your repository.
The agent runs in the cloud and writes its changes to a separate branch. When it finishes, you can review results by clicking View Commits and merge the changes into your working branch by clicking Merge.
