# GitHub automations

Run actions when pull request events match your conditions.

A GitHub automation watches pull request events. It checks your conditions, then runs your actions. It covers every pull request in repositories your workspace watches, including pull requests you did not open. Talyn runs automations on its servers, so the app can stay closed.

## [Create a GitHub automation](/content/docs/workflows#create-a-github-automation/index.html)

1. Select **Integrations** in the sidebar.
2. Open **GitHub > Automations**.
3. Select **New automation** and give it a name, for example "Label new PRs from bots".
4. Under **When this happens**, select **Add trigger** and pick an event.
5. Optionally, under **Only if**, select **Add condition**.
6. Under **Do this**, select **Add action**. Actions run in order, top to bottom.
7. Select **Create**.

Any one of the triggers starts the automation. Every condition must hold.

To open an automation from anywhere in the desktop or web app, press **⌘K** ( **Ctrl+K** on Windows and Linux) and type its name. The command palette lists every automation in the workspace, including Slack, webhook, issue and schedule automations.

## [Triggers](/content/docs/workflows#triggers/index.html)

| Group | Triggers |
| --- | --- |
| Checks | All checks passed, A check suite finished |
| Lifecycle | PR opened, PR reopened, PR closed without merging, PR merged, PR title, body or base changed, New commits pushed |
| Draft | Marked ready for review, Converted to draft |
| Labels and people | Label added, Label removed, Someone assigned, Someone unassigned |
| Reviews | Review requested, Review request removed, Review submitted, Review dismissed |
| Comments | Comment on the diff, Comment on the PR |

**All checks passed** and **A check suite finished** fire only on pull requests that Talyn already tracks.

## [Conditions](/content/docs/workflows#conditions/index.html)

With no conditions, an automation runs on every pull request its trigger fires for. Add conditions to narrow it:

- Repository, base branch, or **Targets the default branch**
- **Opened by**, **Done by**, or **The person named**: Anyone, Me, Any person, Any bot, or specific accounts
- **Title contains**
- **Has any of these labels**, **Has all of these labels**, **Has none of these labels**, or **The label that changed**
- **Draft**: Not a draft, or Drafts only
- **Review verdict**
- **Checks passed or failed**
- **Comment contains**

The editor offers only the conditions that make sense for the triggers you picked.

## [Actions](/content/docs/workflows#actions/index.html)

| Action | What it does |
| --- | --- |
| **Add labels** | Adds labels. Labels already on the pull request stay. |
| **Remove labels** | Removes labels. |
| **Request reviewers** | Requests reviews. The author is left out. |
| **Assign people** | Assigns people. They must be collaborators on the repository. |
| **Post a comment** | Posts a comment on the pull request as Talyn. You can use templates such as `{{pr.author}}` and `{{pr.baseBranch}}`. |
| **Run a skill** | Runs a [skill](/content/docs/skills/index.html) on the pull request with an agent. |
| **Run a prompt** | Runs your prompt on the pull request with an agent. |
| **Add to My PRs** | Tracks the pull request on your **Pull requests** page. |
| **Add to the merge queue** | Queues the pull request. You can pick the merge method: Squash, Merge commit, Rebase, or whatever the pull request is set to. |
| **Run a code review** | Starts a [code review](/content/docs/code-review/index.html). The findings stay in Talyn. |

**Run a skill** and **Run a prompt** run at most once on each pull request.

## [Run history](/content/docs/workflows#run-history/index.html)

On **Integrations > GitHub > Automations**, select **Show history** on an automation to see its runs. Each run shows the pull request, event, and action results. A run is **Running**, **Waiting to retry**, **Done**, **Partly done**, **Failed**, or **Stood down**. When a run starts a session, select **Open the session it started** to go to that session. On mobile, open the automation and tap the run.

**Waiting to retry** means GitHub rate-limited an action. Talyn tries it again later, and does not repeat the actions that already worked.

## [Loop protection](/content/docs/workflows#loop-protection/index.html)

Talyn ignores events caused by its own actions, so an automation does not trigger itself. In **Advanced**, set **Stop after this many runs on one PR per hour**. The default is 5. A run over the limit is recorded as stood down.

## [Cost](/content/docs/workflows#cost/index.html)

GitHub automations are free to create. Actions that run an agent use box-hours. When no box is available, the action waits until there is room.
