> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowdeck.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Git and PR Settings

> Configure commits, pull requests, PR monitoring, and your GitHub connection

Two Settings panes control how FlowDeck commits, opens pull requests, and watches them. These settings support the workflow in [Source Control](https://docs.flowdeck.studio/macos/source-control.md). They never replace an approval request for a remote change.

Open **Settings** from the FlowDeck menu, then choose:

* **Workflows > PR Autopilot** for commits, pull requests, and PR monitoring.
* **Integrations > GitHub** for your GitHub connection, commit identity, and branch naming.

You can also open **PR Autopilot** from the **Settings** link in the PR Autopilot introduction, or from the **PR Autopilot** link in the **Open Pull Request** sheet.

## PR Autopilot

The pane has five groups. Changes apply as soon as you change a control.

### Commits

| Control | What it does |
| - | - |
| **Generate commit messages** | Writes a commit message for your changes. Off by default. |
| **Skip commit confirmation** | Commits as soon as you click **Commit**, without showing the commit form. Appears only when **Generate commit messages** is on. |
| **Automatically push to remote** | Pushes right after each commit that FlowDeck makes from the Changes tab. |

With **Generate commit messages** on and **Skip commit confirmation** off, the commit form opens with a generated message for you to review before you commit.

### Pull Requests

| Control | What it does |
| - | - |
| **Generate PR title and description** | Writes the PR title and description from your changes. Off by default. |
| **Skip PR Confirmation** | Creates the PR without showing the **Open Pull Request** sheet. Appears only when **Generate PR title and description** is on. |

**Skip PR Confirmation** works for GitHub repositories on github.com. To see the sheet for a single PR, Shift+click **Open PR**.

### PR defaults

This group has no heading.

| Control | What it does |
| - | - |
| **Default Target Branch** | The branch pull requests target. The list starts with the repository's default branch and includes the other branches on the remote. |
| **Create PRs as drafts** | Opens new PRs as drafts. Off by default. |
| **Open PR in browser after creation** | Opens the new PR in your browser. On by default. |
| **Delete remote branch after merge** | Deletes the PR's branch on the remote after FlowDeck merges the PR. Off by default. |

### PR Monitoring

| Control | What it does |
| - | - |
| **Monitor PRs** | Watches your open PRs for failing checks and merge conflicts, and asks the agent to fix them. Off by default. |
| **Automatically merge monitored PRs** | Merges a monitored PR once every check passes. Appears only when **Monitor PRs** is on. |
| **Merge method for monitored PRs** | **Squash** (the default), **Merge commit**, or **Rebase**. Appears only when automatic merging is on. |

Turning off **Monitor PRs** hides the two merge controls. See [PR monitoring](#pr-monitoring) below for how it works.

### PR Template

FlowDeck uses the template when it generates a PR title and description.

* **Title** defaults to `[title]`.
* **Description** has sections for what changed, why, how, testing, and notes.

Text in `[brackets]` guides the agent and is not included in the PR. When you change a template, **Reset to default** appears under it.

## GitHub

The **GitHub** pane has three groups.

### Connection

The top row shows **Not connected**, or **Signed in as** your GitHub username. Click **Connect GitHub** to sign in. Click **Disconnect** and confirm to sign out. After you disconnect, you need to reconnect to open or manage pull requests.

If FlowDeck cannot finish setting up Git access for your account, a note appears with a **Retry** button. If it cannot clean up after you sign out, a note appears with **Try Again**. Some notes also offer **Forget**, which stops FlowDeck tracking the credential without deleting anything from your Keychain.

### Commit Identity

Enter a **Name** and **Email** and click **Save**. FlowDeck uses them for commits it creates only when Git's own `user.name` or `user.email` is not set for the repository. They do not change your Git configuration. To remove a saved identity, clear both fields and click **Clear**.

### Automatic Branch Naming

| Control | What it does |
| - | - |
| **Generate branch names automatically** | On by default. When it is off, **New Session** asks you to type the full branch name. |
| **Branch prefix** | The prefix for generated branch names. The default is `agent/`. Click **Reset to default** to restore it. |

## PR monitoring

When **Monitor PRs** is on, FlowDeck checks each open or draft PR about once a minute. It watches the sessions that are open in FlowDeck. Closed sessions keep the last status they had until you reopen them.

What happens depends on the PR:

* **Checks fail or the PR has a merge conflict.** FlowDeck sends the agent a message that names the problem and asks it to fix it and push. FlowDeck only messages an agent that is idle and not waiting for your answer.
* **The agent does not fix it.** FlowDeck asks again every five minutes, up to three more times. After that, the status becomes **Needs Attention** and FlowDeck stops asking.
* **Checks are still running, or the PR waits for a review.** FlowDeck waits.
* **Every check passes and the PR is mergeable.** With **Automatically merge monitored PRs** on, FlowDeck merges it with your chosen method. With it off, the PR stays open for you to merge. If GitHub rejects the merge, for example because a review is required, FlowDeck tries again later.
* **The PR is merged or closed.** Monitoring for that PR ends.

If **Monitor PRs** is off, FlowDeck still shows each PR's status. It does not message the agent or merge anything.

### What you see

In a monitored session, a banner above the message box shows **PR monitored** and the PR's status, for example **PR #42 - Checks Running**. The status is one of:

* **Checks Running**
* **Checks Failed**
* **Merge Conflicts**
* **Pending Approval**
* **Ready**
* **Draft**
* **Merged**
* **Closed**
* **Needs Attention**

Click **Pause** on the banner to stop FlowDeck from messaging the agent or merging that PR. The banner changes to **Monitoring paused**. Click **Resume** to start again.

When a PR is green and mergeable, the main button in the Changes tab changes to **Merge PR**. It uses the merge method you chose in **PR Autopilot**.

> [!NOTE]
>
> Monitoring runs only while FlowDeck is open. Monitoring and automatic merging are settings, not permission to bypass an approval request for a remote change.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.