JetBrains Air Help

Review with agent

Review with agent is an automated review pass performed by an agent. Use it when you want a strong first check that applies your project's constraints and review focus areas consistently. This works especially well before a pull request and human review.

Review with agent does not replace human review. It helps you find issues early and makes the final review faster by turning common checks into repeatable feedback.

How review with agent works

Review with agent runs as a separate review task with a fresh agent session and its own context, so it does not interfere with the main task.

The review context includes:

Review task changes

Use this option when you want to review only the changes created by the current task.

Review task changes with an agent

  1. Open the task changes in one of the following ways:

    • after the task is finished, use the Review with Agent button shown in the Chat tool

      Agentic review button in the Chat tool
    • after the task is finished, open the Task Changes editor tab

      Review with agent in Task Changes tab
    • open the Changes tool and select Current Task to open the Task Changes tab in the editor

    • type / in the task input, choose Review with Agent, and then choose Task Changes as the review scope

      Review with agent with slash
  2. Start the review with Review with Agent.

  3. Wait until JetBrains Air starts and completes the dedicated review task.

    The review runs in a separate agent session and uses its own context, so it does not interfere with the main task.

    Task for agentic review
  4. Review the generated comments in Task Changes and in the Comments tool.

    Select the comments you agree with and click Send to send them to the main task.

    The main agent uses the accepted comments as follow-up instructions and updates the code.

    Agentic review comments

Review all local changes

Use this option when you want the agent to review all uncommitted changes in the current workspace, not only the changes from the current task.

This is useful when task changes are mixed with manual edits or changes from previous tasks.

Review all local changes with an agent

  1. Open all local changes in one of the following ways:

    • open the Changes tool and switch from Current Task to All

    • type / in the task input, choose Review with Agent, and then choose Local Changes as the review scope

  2. If you used the Changes tool, make sure the All Changes tab is open in the editor.

    The Changes tool is used to select which changes are shown.

    Review with agent in All Changes tab
  3. In the All Changes tab, click Review with Agent. Or, if you started from the command, confirm Local Changes as the scope.

  4. Review the generated comments and send the accepted ones to the main task.

Review another scope

Use this option when you want to review something other than task changes or all local changes. For example, you can review specific files, folders, commits, or branches.

Start this review from the task input: type /, choose Review with Agent, and then select the scope you want to review.

Review another scope with an agent

  1. In the task input, type /.

  2. Select Review with Agent.

  3. Select the scope you want to review, such as files and folders, Git commits, or Git branches.

  4. Wait until the review finishes, then inspect the review comments and send the accepted ones to the main task.

Use a different agent for review

By default, review with agent uses the review model configured in settings. Change it when you want review to be performed by a different agent than the one that implemented the change, for example, to get a more independent second opinion.

Change the review agent

  1. Open Settings.

  2. Open the Global tab and go to AI | Review.

  3. In Agent review model, select the model you want to use for review.

Adjust the review prompt

The global review prompt is used by default for review with agent in all projects. Change it when you want to update your default review focus, for example, to emphasize code style, security checks, test quality, or project-specific conventions that you commonly use.

Edit the global review prompt

  1. Open Settings.

  2. Open the Global tab and go to AI | Review.

  3. Next to Agent review prompt, click Edit.

  4. Update the prompt and save it.

Use a project-specific review prompt

A project-specific review prompt overrides the global review prompt for one repository. Use it when a project has its own review rules, constraints, or focus areas that should not affect your default review behavior in other repositories.

The project-specific review prompt is stored in the repository: .air/review/review-prompt.md.

Edit a project-specific review prompt

  1. Open Settings.

  2. Select the project tab.

  3. In the project settings, find the AI | Review section.

  4. Next to Agent review prompt, click Edit.

  5. Update the project-specific review prompt and save it.

If a project-specific review prompt exists, JetBrains Air uses it instead of the global review prompt.

04 May 2026