Repositories
Unlike local runs, cloud environments do not already have your project checked out. To make repositories available in JetBrains Air, configure integration with a supported VCS provider: GitHub or GitLab.
Repository access is based on the JetBrains Air connection app installed in your VCS provider.
You can start the connection flow from the web version of JetBrains Air. In JetBrains Air and AI Assistant in IntelliJ-based IDEs, repository authorization is started from the cloud task flow.
Connect repositories from a VCS provider
Start the connection flow.
In the web version of JetBrains Air, go to , find your VCS provider, and click Connect.
Start creating a task and select a cloud run environment. See how to do it in JetBrains Air and in AI Assistant. The task flow prompts you to connect the provider when access is needed.
If the JetBrains Air connection app isn't authorized yet, click Authorize and complete the provider's authorization flow.
Authorizing lets the app act on your behalf in the provider, for example, to read code and open pull requests. It doesn't widen what you can reach – you never gain access to repositories you can't already access in the provider.
After the connection is established, the connected provider appears in the web version of JetBrains Air under , showing the connected account and the organizations available through that connection.
Finish the flow. What happens next depends on your VCS provider.
GitHub – authorization grants access to your personal repositories but not to organization repositories.
If the task still can't run, read access to the target repository is required. Click Manage to open GitHub and either grant the app access to the repository or request access if you aren't entitled to grant it. See Manage repository access.
GitLab – authorizing completes the connection. Cloud tasks can use every repository you can access in GitLab, with no extra step.
How repository access works
JetBrains Air connection app
When you connect a VCS provider, JetBrains Air installs a provider-specific connection app (also called JetBrains Air) into your VCS provider account and grants it access to all or selected repositories.
- The connection app is installed per account, not per repository
The JetBrains Air connection app is installed into a VCS provider account – a personal account or an organization – not into individual repositories. You install it once per account, then choose which repositories that installation can access: all repositories or only selected ones. You can change this selection at any time (see Manage repository access).
Connecting a VCS provider involves two distinct actions:
Installing the app – an administrator installs the JetBrains Air connection app into a VCS provider account – a personal account, organization, or group – and chooses which repositories the app can access. This is what makes those repositories available to JetBrains Air.
Authorizing the app – each user authorizes the JetBrains Air connection app to act on their behalf, for example, to view issues and create pull requests. On GitHub, this is an OAuth flow.
Sometimes one person performs both actions. For example, when you connect your own personal account, you both install the app for that account and authorize it to act on your behalf. For an organization, an administrator usually installs the app, and each user then authorizes it for themselves.
- Whose access the agent uses
When a cloud task reads your code or opens a pull request, it acts within your own access rights and never sees repositories you can't already access in the VCS provider. Connecting the app doesn't widen what you can reach – it only lets JetBrains Air act on the repositories you already have access to.
To the VCS provider, access goes through the JetBrains Air connection app with your authenticated user as the principal, so the provider's own permissions gate every action.
Within JetBrains Air, the cloud task operates under your user or service account.
GitHub
- Who can grant the app access to a repository
A user can grant app access in these cases:
Personal repositories – if the app is installed in the user's personal account, the user can grant access to their personal repositories.
Organization repositories – organization owners can grant the app access to organization repositories.
Repository admins – repository administrators can grant access to repositories they administer, if the organization allows repository administrators to install GitHub apps.
Users with only normal read or write access cannot directly grant the app access to a repository. On GitHub, such repositories can appear with a Request badge instead.
If you aren't an owner or repository admin, you can't install the app yourself. When you start the connection flow, GitHub sends an installation request to your organization's owners, similar to requesting any other third-party GitHub app. After an owner approves and installs the app, you can authorize it for yourself and access the repositories you're entitled to.
- How to make a repository appear in JetBrains Air
Installing the app for an organization does not mean that every repository in that organization will appear for every user in JetBrains Air.
A repository appears in JetBrains Air only if both of the following are true:
the app installation has access to that repository
the user has explicit repository access in GitHub
Repository type
When it appears in JetBrains Air
Personal repository
The app is installed in the personal account and has access to the repository.
Organization public repository
The organization installation has access to the repository.
Organization private repository
The organization installation has access to the repository, and the user has explicit repository access in GitHub.
Organization internal repository
The organization installation has access to the repository, and the user has explicit repository access in GitHub. Organization membership alone is not enough.
Internal repositories need special attention. A user may be able to open an internal repository directly in GitHub because they belong to the organization, but the same repository still may not appear in JetBrains Air.
For internal repositories, the usual fix is to grant the user explicit repository access, for example through a team or a direct collaborator role.
GitLab
- How repository access works in GitLab
GitLab repository access in JetBrains Air also goes through the JetBrains Air connection app. Air starts the flow, and the app is then installed and authorized in GitLab.
The repositories that appear in JetBrains Air depend on:
which repositories the app is allowed to access
which repositories the current user is allowed to access in GitLab
Set up organization repository access
To make organization repositories available in JetBrains Air, the JetBrains Air connection app must first be installed for that organization in the VCS provider.
This first step must be done by a user with sufficient administrative permissions in that organization. For GitHub-specific details, see Who can grant the app access to a repository.
Grant JetBrains Air access to organization repositories
In the web version of JetBrains Air, go to .
Find the required VCS provider and click Connect.
In the provider flow opened by the web version of JetBrains Air, install the JetBrains Air connection app for the organization.
Grant the app access either to all organization repositories or only to selected repositories.
Only the repositories granted to the app at this stage can later appear in JetBrains Air.
After that, users from that organization can connect the same provider in JetBrains Air and access the repositories that are available to them according to the provider's access rules.
Manage repository access
On GitHub, you choose which repositories the JetBrains Air connection app can access. You can open repository access management from in the web version of JetBrains Air, or from the Manage button shown in the task flow when a task needs read access to a repository.
Manage repository access
In the web version of JetBrains Air, open .
Find the connected provider and click Settings.
Select the personal account or organization account you want to manage.
Update repository access for that account.
For example, in GitHub you can choose:
All repositories – the app can access all current and future repositories in that account
Only select repositories – the app can access only the repositories you choose
For a personal account, switching to Only select repositories lets you choose which of your repositories the app can access.
For an organization account, the list can also include repositories that are allowed for the app installation but that you cannot grant yourself. On GitHub, such repositories can appear with a Request badge. You can request access to those repositories from this screen.
Save the changes.
If a repository does not appear in JetBrains Air
If a repository is missing from the repository list in JetBrains Air, check the following:
the provider is connected in Air
the app installation has access to that repository
you are connected to the correct personal or organization account
you have the required repository access in the VCS provider
for GitHub internal repositories, you are not relying only on organization membership visibility