Manage automations

Browse automations and their runs

1. Log in to https://air.jetbrains.cloud with your JetBrains Account.

2. Open the Automations page.

3. In the main list, choose which automations to show:

   • Project for automations shared within a project

   • Personal for your personal automations

4. To make the list easier to browse, group and sort it:

   • Group by Project, Group by Repository, or Group by Status – splits the list into collapsible groups. Select No Grouping for a flat list.

   • Sort by Name or Sort by Last Run – sets the order inside each group.

5. Select an automation in the list. This will open the page with automation details and the list of its runs.

6. To inspect a specific run, click it in the Runs section.

   The run opens with its summary and links. Depending on how the trigger handled the run's changes, you can read the run's full chat, open a pull request, continue the run in a new task, or repeat it with the same input – see Work with automation run results.

   

Filter and search the automation list

^{Use filters and search to quickly find the automations you need.}

1. On the Automations page, choose which automations to show:

   • Project for automations shared within a project

   • Personal for your personal automations

2. Click Filters and narrow the list down by Project, Repository, or Status – Active or Paused. Click Reset to clear every filter at once.

   

3. To search by automation name, click the search icon and type your query.

Edit an automation

^{You can always edit your personal automations. To edit a project automation, you need to be an admin in that project and have access to its repository in the VCS provider.}

1. Open the Automations page and select the automation.

2. Start editing in one of the following ways:

   • click Edit in the automation header

   • open the automation menu and click Edit

3. Change the automation settings.

4. Click Save.

Run an automation manually

^{Use this to test an automation or start it on demand without waiting for a trigger.}

1. Open the Automations page and select the automation.

2. Start the run in one of the following ways:

   • select the automation and click Run Now on its details page

   • open the automation menu and click Run Now

   

3. In the Test Automation Manually dialog, set up the run:

   • Select the branch to check out.

   • Select how to handle the changes the run produces – see Change handling.

   • Optionally, enter Context for the run. The context stands in for the data a trigger would normally provide, such as an issue link, a pull request, or event details. Leave it empty to run the automation with no payload.

   

4. Click Run.

Stop a run in progress

^{Stop a run that is still in progress if you no longer need its result or started it by mistake.}

1. Open the Automations page and select the automation.

2. In the Runs section, find the run that is still in progress and click the stop icon next to it.

Pause and resume an automation

^{If you want an automation to stop reacting to its triggers for a while, pause it instead of deleting it. When you want it to run again, resume it.}

1. Open the Automations page and select the automation.

2. Open the automation menu and click Pause. The automation stays in the list in the Paused state but no longer starts when its triggers fire.

3. To resume, open the automation menu and click Resume. The automation reacts to its triggers again.

Assign an automation to a project

^{Assign an automation to a project so project admins can manage it and project members can use it. The project decides whether its runs spend the project's AI credits or the creator's – see AI credits for project automations. You can change the project at any time.}

1. Open the Automations page and select the automation.

2. Click Edit in the automation header.

3. Open the scope selector under the automation name and choose a project. Choose Personal to make the automation personal again.

   

4. Click Save.

   If the project runs its automations on its own AI credits, the run stops acting as you and starts acting as the project – so it reaches the repository through the project's access rather than yours. See How automation runs reach the repository. On a GitLab repository, the automation is paused until the project has a GitLab token – see When JetBrains Air Teams pauses an automation.

Duplicate an automation

^{Use this to create a new automation based on the existing one.}

1. Open the Automations page and select the automation.

2. Open the automation menu and click Duplicate.

3. Update the copied automation settings if needed.

4. Click Save.

Delete an automation

^{Use this to remove an automation you no longer need.}

1. Open the Automations page and select the automation.

2. Open the automation menu and click Delete.

3. Confirm deletion.