---
title: "Create a pull request"
description: "Send the agent's code changes to your engineers as a pull request on GitHub, from Build Mode or from the canvas header."
url: https://help.modeinspect.com/en/articles/46-create-a-pull-request
collection: "Share and review"
updated: 2026-10-29
language: en
---

# Create a pull request

Send the agent's code changes to your engineers as a pull request on GitHub, from Build Mode or from the canvas header.

A pull request puts the agent's code changes on a branch of your repository, where your engineers review and merge them. Create it once the change looks right in Build Mode. One canvas has one pull request.

**Before you start**

-   A canvas of a codebase connected to GitHub, see [Connect a GitHub repository](https://help.modeinspect.com/en/articles/11-connect-a-github-repository.md). The demo codebase has no repository.
    
-   At least one code change, see [See the code the agent changed](https://help.modeinspect.com/en/articles/49-view-code-changes.md).
    

## Steps

1.  In Build Mode, click **Sync to Github** above the message field. The button appears next to the **Changes** count after the agent's first change.
    
2.  Wait while it reads **Syncing…**. The agent writes the title and description from the changes.
    
3.  When it reads **Synced**, the pull request exists. The GitHub button in the header gets a green dot.
    

The strip disappears a moment later. From now on, click the GitHub button in the header and then **View on Github** to open the pull request for your engineers.

## Write the title yourself

To edit the text before the pull request is created, use the header instead of the strip.

1.  Click the GitHub button in the canvas header. The **Github Sync** popover opens.
    
2.  Click **Sync to Github**. The **Create Pull Request** dialog opens with a **Title** and **Description** the agent is already filling in.
    
3.  Edit either field. **Summarize** writes both again from the current changes.
    
4.  Click **Create**. The toast reads "Changes synced to Github".
    

The branch is named after the canvas. The description ends with your email as the designer and a link back to the canvas.

## A draft canvas

A canvas started from a blank codebase has no repository. Its GitHub button opens **Create a GitHub project** instead of the popover. Once the project exists, the canvas syncs like any other, see [Start from a blank codebase](https://help.modeinspect.com/en/articles/15-start-from-a-blank-codebase.md).

## If it does not work

-   **The popover says "Nothing to sync yet. Make some changes in the codebase to get started."**: the agent has not changed any code, or every change was undone. **Sync to Github** stays disabled until there is a change.
    
-   **A toast starting with "Nothing to publish"**: the latest change reverted an earlier one, so the code equals your branch. Make the change you want and sync again.
    
-   **A toast starting with "Changes moved on"**: the agent replied while the text was being written. Click **Sync to Github** once more.
    
-   **"Couldn't sync to Github"** or **"Error opening Pull Request"**: the pull request was not created. Try again. If it fails twice, ask whoever connected the repository to check that Modeinspect still has access to it.
    
-   **No Sync to Github anywhere**: the canvas already has a pull request. The GitHub button shows it, see [How changes reach your pull request](https://help.modeinspect.com/en/articles/47-how-changes-reach-your-pull-request.md).
    

## Related

-   [How changes reach your pull request](https://help.modeinspect.com/en/articles/47-how-changes-reach-your-pull-request.md)
    
-   [See the code the agent changed](https://help.modeinspect.com/en/articles/49-view-code-changes.md)
    
-   [Connect a GitHub repository](https://help.modeinspect.com/en/articles/11-connect-a-github-repository.md)

## Related

- [See the code the agent changed](https://help.modeinspect.com/en/articles/49-see-the-code-the-agent-changed.md)
- [How changes reach your pull request](https://help.modeinspect.com/en/articles/47-how-changes-reach-your-pull-request.md)
- [Keep working after your pull request is merged](https://help.modeinspect.com/en/articles/44-keep-working-after-your-pull-request-is-merged.md)
- [Create a preview link](https://help.modeinspect.com/en/articles/45-create-a-preview-link.md)
- [Share a link to the page you are on](https://help.modeinspect.com/en/articles/48-share-a-link-to-the-page-you-are-on.md)