# Agents in CLion

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

Procedure: Enable the Air plugin

This functionality relies on the [Air](https://plugins.jetbrains.com/plugin/33314-air)  plugin, which  is bundled and enabled in CLion   by default. If the relevant features are not available, make sure that you did not disable the plugin.

1. Press `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) to open settings and then select `Plugins`.

2. Find the Air plugin and click Enable.

## IDE intelligence for coding agents

CLion integrates the coding agents of your choice directly into your project workspace, allowing them to query and act based on CLion's  [parsed, indexed, and inferred model of your codebase](project-analysis.html), knowledge about the project context, and framework-aware resolution.

CLion's [inspections](customizing-profiles.html) and [integrated static analysis tools](code-inspection.html) provide agents with deterministic checks to validate their changes, saving the tokens and context that model-based review would spend.

> **Tip: CLion MCP server**
> CLion's code intelligence, framework support, and static analysis features are exposed to coding agents through [CLion MCP server](mcp-server.html).

For review and validation of an agent's changes, CLion provides fine-grained diff and rollback tools, while [Local History](local-history.html) lets you compare and restore intermediate states even when the agent creates no VCS commit.

## Agent workspace in CLion

The Agent workspace is CLion's agent-centric development environment. It provides the workspace for managing multiple agents and agent sessions in parallel across repos and tasks. You can run agents locally, in the cloud, or isolated in a temporary worktree.

![Agent workspace in CLion](https://resources.jetbrains.com/help/img/idea/2026.3/ij_agent_workspace.png)

You can work with both agent sessions and project files  in the editor tabs simultaneously, without having to switch between the editor and agent workspace views.

## Open and manage Agent Sessions

To start a new agent session:

Agent widget:

Procedure:

* Click the agent widget in the main toolbar to start an empty session with the currently selected agent or preset.

![Main toolbar with the agent widget icon and dropdown arrow highlighted for starting a new agent session.](https://resources.jetbrains.com/help/img/idea/2026.3/air_use_widget_to_start_session.png)

To use another agent or preset, click ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.chevronDown.svg) next to the widget and select it from the list.

![Agent widget menu in the main toolbar listing the agents and presets available for a new session, and the Manage Agents item.](https://resources.jetbrains.com/help/img/idea/2026.3/air_widget_overview.png)

Agent Sessions tool window:

Procedure:

1. Open the Agent Sessions tool window. If it is not visible, select `View | Tool Windows | Agent Sessions`.

2. Click New Session to start a new session with the currently selected agent or preset.

![Agent Sessions tool window showing the New Session control at the top and a list of existing sessions below it.](https://resources.jetbrains.com/help/img/idea/2026.3/air_start_session_in_tool_window.png)

To use another agent or preset, click ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.chevronDown.svg) next to the button and select it from the list.

![Agent Sessions tool window with the list next to New Session expanded, showing the available presets with the current one selected.](https://resources.jetbrains.com/help/img/idea/2026.3/air_agent_session_tool_window_overview.png)

Global prompt:

Procedure:

1. Press `Ctrl` twice to open the global prompt. You can invoke it from anywhere in the IDE.

![Global prompt with the preset list, quick action suggestions, attached code context, and a text field for the request.](https://resources.jetbrains.com/help/img/idea/2026.3/air_global_prompt_overview.png)

2. To use another agent or preset, click the currently selected one and select the required one from the list.

![Global prompt with the preset list open, listing the available presets and the Add Agents and Manage Presets actions.](https://resources.jetbrains.com/help/img/idea/2026.3/air_start_session_from_global_prompt.png)

3. Type your request in the text field and press `Enter`.

Learn more:

* [Continue an existing session](https://www.jetbrains.com/help/air/air-in-ides-start-a-session.html#continue-session)

* [Start a session in a new worktree](https://www.jetbrains.com/help/air/air-in-ides-start-a-session.html#temporary-worktrees)

* [Run an agent in the cloud](https://www.jetbrains.com/help/air/air-in-ides-start-a-session.html#cloud-runs)

## Features for working with agents

### Multi-agent setups

CLion works with the agents, provider accounts, and subscriptions you already have, along with providing a curated registry of agents you can browse, install, and set up from your IDE.

[Agent presets](https://www.jetbrains.com/help/air/air-in-ides-presets.html) are reusable configurations defining which agent, operation mode, model and reasoning effort are used for the current agent session, allowing you to easily switch between agents or agent setups for different types of tasks.

Locally installed agents
: If you already have coding agents installed on your machine, CLion detects them     .
:
:
:
: An agent that is already present in your environment, such as Claude Code or Codex, becomes available in the IDE with the configuration it already uses.

Registry of available agents
: A curated catalog of ACP-compatible agents you can browse from CLion. The IDE reads the registry from a JetBrains-hosted online JSON file by default, and your organization can provide its own registry.
:
:
:
: Because [Agent Client Protocol
: (ACP)](https://agentclientprotocol.com/get-started/introduction) is a standard interface, compatible agents can work with CLion without a dedicated integration.

Learn more:

* [Browse, install, and update agents](https://www.jetbrains.com/help/air/air-in-ides-manage-agents.html)

* [Authorization options](https://www.jetbrains.com/help/air/air-in-ides-authorization.html)

### Context and cost management in agent sessions

For each agent session, you can attach context such as files and folders, commits, context from the screen, or specific agent skills.

![Context picker listing Project Files and Folders, Upload from Computer, Context from Screen, Commits, and Skills, plus a list of recent files.](https://resources.jetbrains.com/help/img/idea/2026.3/air_attach_context.png)

After you send the first prompt, a context indicator also appears in the text field. Hovering over it shows how much of the model's context window is used in the current session. Prompts, attached context, and agent responses contribute to this usage, and the indicator updates as the session continues.

![Agent Session View with the context indicator tooltip open, showing the percentage of context used and the used, available, and capacity token counts.](https://resources.jetbrains.com/help/img/idea/2026.3/air_agent_session_view_context_indicator.png)

Learn more:

* [Agent Session View overview](https://www.jetbrains.com/help/air/air-in-ides-interact-with-the-agent.html#agent-session-view)

* [Configure agent settings](https://www.jetbrains.com/help/air/air-in-ides-interact-with-the-agent.html#agent-settings)

* [Add a prompt to a queue](https://www.jetbrains.com/help/air/air-in-ides-interact-with-the-agent.html#prompt-queueing)

### Diff review and output validation tools

When you review the changes, you can ask the agent questions about them or request improvements by adding notes to the code snippets that you want explained or reworked.

![Code Review tab with a saved note card on line 28 and a note draft on line 32 that shows the Add sorting by due date session with the In code review label.](https://resources.jetbrains.com/help/img/idea/2026.3/air_code_review_add_note.png)

Learn more:

* [Review changes with code notes](https://www.jetbrains.com/help/air/air-in-ides-review-changes.html#code-review)

* [Generate a commit message](https://www.jetbrains.com/help/air/air-in-ides-review-changes.html#generate-commit-message)

* [Resolve merge conflicts with an agent](https://www.jetbrains.com/help/air/air-in-ides-review-changes.html#merge-conflict-resolution)

## Learn more

[JetBrains Air](https://www.jetbrains.com/help/air/air-in-ides-overview.html)
: The detailed guide to the [JetBrains Air](https://plugins.jetbrains.com/plugin/33314-air-alpha) features in JetBrains IDEs.

[MCP server](mcp-server.html)
: The full list of CLion tools available for coding agents via MCP server.

