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

# GitHub

> Keep Roomote changes on normal repository review paths.

The GitHub integration lets Roomote access selected repositories, review pull requests, create branches, open pull requests, and respond to repository events. Repository-changing work still flows through normal GitHub review paths.

## Setup

<Steps>
  <Step title="Install the GitHub app">
    Connect GitHub during onboarding or from **Settings**. Choose the
    organization and repositories Roomote should be able to access.
  </Step>

  <Step title="Create an environment">
    During onboarding, pick the first repositories and let Roomote start the
    environment setup task. Later, add connected repositories to more
    environments as needed.
  </Step>

  <Step title="Enable automations if needed">
    Admins can turn on review, conflict-resolution, or other repository
    automations from **Settings**.
  </Step>
</Steps>

## What Roomote can do

* review pull requests
* answer or act on `@roomote` mentions
* create implementation branches and pull requests
* inspect repository context during tasks
* use pull request and issue context when a task starts from GitHub
* help with merge conflicts and follow-up fixes when the relevant automation is enabled
* suggest improvements from PR feedback and recurring repository signals

## Pull request follow-up

Mention Roomote on a pull request when you want another review pass or a follow-up change. Roomote links the GitHub conversation to a Roomote task so you can inspect the full run in the dashboard.

You can mention Roomote in a normal pull request comment, an inline review
thread, or the text of a submitted review such as **Requested changes**.

<Note>
  A linked personal GitHub account is optional. If a teammate has not linked
  GitHub in **Personal Settings**, Roomote still opens the pull request through
  the shared GitHub App, so GitHub shows the Roomote GitHub App as the PR
  author or assignee. The PR description may still mention that teammate's
  Roomote display name for context.
</Note>

Good GitHub asks include:

* "Review this PR for regressions."
* "Apply the feedback from this thread."
* "Fix the merge conflict on this PR."
* "Explain whether this change needs a migration."
* "Open a follow-up PR for the missing test coverage."

<Note>
  Roomote only works with repositories and permissions granted through the
  GitHub App installation.
</Note>