# Air in IDEs settings

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/help/air/llms.txt).

Air in IDEs settings are grouped under `Tools | Air`. Which agents are available, and whether an agent starts in the chat or terminal surface, is set on the Agents page instead. For information about available agents, refer to [Browse, install, and update agents](air-in-ides-manage-agents.html). For information about the model, effort, and mode that an agent starts with, refer to [Configure and manage presets](air-in-ides-presets.html).

## Air

> **TL;DR**
> `Tools | Air`

![Tools | Air settings with Agents, Presets, and Sounds groups: automatic agent updates, the preset for new sessions, and sound events.](images/air_settings_general.png)

| Setting | Description |
| --- | --- |
| Automatically update agents |  Download updates for agents in the background. Agents whose current terms you have not accepted are not updated, and running sessions keep the version that they started with.  |
| Prevent system sleep while agents are working | Keep the system awake while an agent is working or while a session is waiting for your review. |
| Start a new session with |  Choose whether new sessions start with the Last used agent or preset or with the Default agent or preset.  |
| Play Air sounds | Play sounds for agent events and dictation. Clear the checkbox to turn off all Air in IDEs sounds. |
| Play a sound when |  Select the events that play a sound:     * An agent finishes its work    * An agent stops with an error    * An agent needs your input   Air in IDEs plays these sounds only when you are not viewing the chat of the session. To preview a sound, click ![](images/app.expui.run.run.svg) next to the event.  |
| Play sounds when starting or stopping dictation |  Play a sound when you start or stop [dictating a prompt](air-in-ides-interact-with-the-agent.html#voice-input).  |

## Accounts

> **TL;DR**
> `Tools | Air | Accounts`

Configure the AI providers that agents work through. Add a provider for every API key that you have, and switch between the configured providers as your tasks require.

![Tools | Air | Accounts settings with the AI Providers list, the source of the monthly credits, and the More Providers button.](images/air_settings_accounts.png)

| Setting | Description |
| --- | --- |
| AI Providers |  The providers that agents work through. Each entry shows the provider and the kind of credentials that it uses, for example a personal API key. Use ![](images/app.expui.general.moreVertical.svg) on an entry to edit the provider or to delete its configuration.  |
| More Providers |  Add a provider and fill in the details that it requires, such as its API key. The set of fields depends on the provider that you select.  |

If your organization supplies AI access, the AI Providers list also holds an entry for your JetBrains Account. The list on that entry holds the organizations that supply credits to your account. The text next to the list shows how many of your monthly credits are left. Use ![](images/app.ide.external_link_arrow.svg) on that entry to open your JetBrains Account settings in the browser.

## Sessions

> **TL;DR**
> `Tools | Air | Sessions`

![Tools | Air | Sessions settings with Session List, Windows and Tabs, and Indicators groups, with the agent activity counters set to Never.](images/air_settings_sessions.png)

| Setting | Description |
| --- | --- |
| Show only sessions from the current project |  Limit the Agent Sessions tool window to the current project. Clear the checkbox to list the sessions of all projects. The default value depends on whether sessions open in a separate window.  |
| Show session cost | Show the exact or estimated cost in session metadata. |
| Open sessions in a separate window | Open sessions in a separate window instead of the frame of the source project. |
| Use `Alt+2` (Windows), `⌘ 2` (macOS), `Alt+2` (Linux) for Agent Sessions |  Override the shortcut so that it opens the Agent Sessions tool window. By default, the shortcut opens the Bookmarks tool window, which is where it returns when you clear the checkbox.  |
| Use a compact New Session button in the main toolbar |  Show only the agent icon on the New Session button in the main toolbar. Clear the checkbox to show the New Session label as well.  |
| Color session tabs by source project |  When project colors are enabled, give the separate session window the color of its source project. This setting does not affect the color labels that you add to sessions in the Agent Sessions tool window.  |
| Show agent activity |  Choose where to show the counters of sessions that need your attention, are running, or have recently completed: Never, Agent Sessions Title Bar (the header of the Agent Sessions tool window), Main Toolbar, or Both. The session list and the tool window stripe always show this activity. For more information, refer to [Track agent activity without the tool window](air-in-ides-manage-sessions.html#agent-activity-indicators).  |
| Use the Caps Lock LED for agent activity |  On macOS, use the LED of a compatible `Caps Lock` key to signal [agent activity](air-in-ides-manage-sessions.html#agent-activity-indicators). Air in IDEs uses the Input Monitoring permission only to control the LED: it does not read the text that you type or change the `Caps Lock` state.  |
| Show Claude usage in status bar | Show your Claude usage in the status bar. |
| Show JBCentral quota in status bar | Show how much of your JetBrains Console quota is left in the status bar. |

## Chat

> **TL;DR**
> `Tools | Air | Chat`

![Tools | Air | Chat settings with the separate tool window option, message alignment, follow-up queueing, link targets, and default views.](images/air_settings_chat.png)

| Setting | Description |
| --- | --- |
| Show chats in separate toolwindow |  Open sessions in the Chat tool window on the right side of the main window instead of in editor tabs. For more information, refer to [Open sessions in the Chat tool window](air-in-ides-manage-sessions.html#chat-tool-window).  |
| User message alignment | Place your messages on the Left or Right side of the conversation. |
| Limit message width to | Wrap messages at the specified number of characters instead of using the full width of the view. |
| While agent is working, put the follow-up messages in the queue |  Add follow-up messages to the [queue](air-in-ides-interact-with-the-agent.html#prompt-queueing) while the agent is working. Press `Enter` (Windows), `⏎` (macOS), `Enter` (Linux) to queue a message and `Ctrl` (Windows), `⌘` (macOS), `Ctrl` (Linux) + `Enter` (Windows), `⏎` (macOS), `Enter` (Linux) to send it right away. When you clear the checkbox, the two shortcuts swap.  |
| Show playful status words while the agent is working |  Show words like Pondering or Brewing instead of Running in the status of a working agent.  |
| Open files and local links in |  Choose where files and local links open:     * New tab: open the file or local link in an editor tab.    * Split: open the file or local link in an editor split, which keeps the chat visible next to it. Use this target to read the response of the agent and inspect the file that it refers to at the same time. This is the default target.    * Adaptive: choose the target from the layout that is available: * If the chat is docked and there is enough space, the file opens in a split. * If the chat is docked and there is not enough space, the file opens in an editor tab. * If the chat is detached from the main IDE window, the file opens in the main IDE window.     |
| When Chat is detached, open targets in the main IDE window |  While a chat is detached from the main IDE window, open files and links in the main window instead of in the detached one. `Ctrl` (Windows), `⌃` (macOS), `Ctrl` (Linux) + `Click` sends a single link to the main IDE window.  |
| Open web links in |  Choose whether web links open in the IDE browser or in an External browser.  |
| Markdown files |  Open the Markdown files that a session lists in Preview or in Source.  |
| Local HTML files |  Open the local HTML files that a session lists in the IDE browser or in Source.  |
| Diff listed entries |  Open the diff entries that a session lists in the Diff viewer or in Source.  |

## Worktree

> **TL;DR**
> `Tools | Air | Worktree`

Configure where Air in IDEs creates temporary worktrees and when it deletes them, and manage the worktrees of each project. For information about running sessions in worktrees, refer to [Fork in a new temporary worktree](air-in-ides-start-a-session.html#temporary-worktrees).

![Tools | Air | Worktree settings with the worktrees root directory, the limit and cleanup options, and two worktrees listed for the selected project.](images/air_settings_worktree.png)

| Setting | Description |
| --- | --- |
| Worktrees root directory |  The directory where Air in IDEs creates temporary worktrees. By default, it is `~/.air/worktrees/temporary`.  |
| Set a limit of worktrees per project |  Limit the number of temporary worktrees that Air in IDEs keeps for each project. This option is disabled by default.  |
| Automatically delete temporary worktrees after days of inactivity |  Delete the temporary worktrees that have not been used for the specified number of days. This option is disabled by default. Uncommitted changes in a deleted worktree are lost.  |
| Worktrees list per project |  Select a project to list its temporary worktrees. Each entry shows the name and path of the worktree, its status, such as Uncommitted, and when it was last used. To delete a worktree, hover over its entry and click ![](images/app-client.expui.general.delete.svg). Uncommitted changes in the worktree are lost.  |