Set up Air app
The Air app runs agent tasks on your own machine, and it can also start and open JetBrains Air Teams tasks that run in the cloud. Install it, connect at least one AI provider, and you're ready to run a task – see Quickstart with Air.
Required tools
Make sure the following tools are installed:
Git – required for working with repositories and task branches.
Docker and Docker Desktop – required only if you want to run tasks in containers.
Other Docker runtimes (for example, Colima) may work but can require additional configuration. If you use an alternative runtime, make sure Docker commands work from the terminal before you use Docker tasks in the Air app.
Install the Air app
You can install the Air app on the following OSs:
macOS – download the Air app for macOS from the official page at air.dev or install it through JetBrains Toolbox
Linux – run the install script:
curl -fsSL https://jb.gg/air-install.sh | shYou can also install the Air app for Linux through JetBrains Toolbox
Windows – install the Air app for Windows through JetBrains Toolbox
Connect AI providers
AI providers are required to run agentic tasks. On the first start of the Air app, you must connect at least one provider before you can continue.
If you want to connect additional providers later, use Settings.
Connect an AI provider
Open Settings (⌘ ,) and go to .
Click Connect next to the provider you want to use.
If you have a JetBrains AI subscription, connect JetBrains AI. It works as a universal provider and unlocks multiple agents (Claude Agent, OpenAI Codex, Gemini CLI, and Junie) under one subscription, with usage tracked through AI credits.
If you already use a specific provider account, connect it directly.
Follow the login flow. For most providers, you can choose the account type you already use, for example, a subscription account or an API billing account.