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

# GitHub

> Pull requests, code review, and automated workflows.

![GitHub](https://mintcdn.com/test-8862363a/_KF7n4fDwDrxMgZe/images/integrations/github.png?fit=max\&auto=format\&n=_KF7n4fDwDrxMgZe\&q=85\&s=16eb158bfa52a1dc0deaf0463bd57760)

## Features

* Open pull requests with code changes
* Review PRs with inline comments
* Respond to PR feedback and iterate
* Start work from GitHub issues
* Auto-fix failed GitHub Actions workflows
* Signed and verified commits on all Tembo PRs

## Installation

**1. Install**

Go to **Settings > Integrations** and click **Install** next to GitHub.

**2. Authorize**

Choose **All repositories** or **Selected repositories** and authorize.

**3. Activate**

Select which repositories Tembo should work with under "Active Repositories".

## Usage

### PR comments

Comment `@tembo` on any pull request to request changes. Works in the main thread or as inline review comments on specific lines. Tembo reads the feedback, updates the code, and pushes new commits.

```
@tembo Please add error handling to this function
```

Works on PRs created by Tembo and PRs created by your team.

### Issues

Comment `@tembo` on any issue to start implementation. Tembo reads the issue title and description, then opens a PR.

```
@tembo Implement the API endpoint described in this issue
```

Tembo only responds to `@tembo` mentions from members of your Tembo workspace who have connected their GitHub account in **Settings > Connected accounts**. If someone else tags Tembo, it replies once with a link to connect their account and doesn't start a session.

## Agents

See [Agents](https://docs.tembo.io/features/agents.md#event-driven) for available GitHub event triggers.

GitHub triggers for PRs opened, closed, merged, marked ready for review, or updated with new commits include Tembo-created PRs by default. To exclude them, disable the `temboPrs` filter on the trigger. Explicitly disabled filters stay disabled, and other trigger filters still apply.

### PR reviews

Reviews pull requests for bugs, security issues, and code quality. Leaves inline comments automatically when a PR is opened.

### Enrich issues

Adds codebase context to new GitHub issues, helping agents and teammates understand the relevant code before starting work.

### Failed workflows

Detects GitHub Actions failures and opens fix PRs automatically.

## Advanced

> [accordion] Attribution
>
> By default, PRs and commits are made under the Tembo bot account. To attribute them to your GitHub user instead, connect your personal GitHub account in **Settings > Connected accounts**.
>
> Org admins can require this: turn on **Require personal GitHub accounts** under **Session requirements** in **Settings > Workspace** to block members from starting sessions until they connect a personal GitHub account.

> [accordion] Require personal GitHub accounts
>
> Workspace admins can require every member to connect their personal GitHub account before starting sessions. Enable **Require personal GitHub accounts** under **Session requirements** in **Settings > Workspace**.

> [accordion] Signed commits
>
> All commits in Tembo PRs are automatically signed and verified with a "Verified" badge in GitHub.
> No configuration needed.

> [accordion] Merge or close actions
>
> Tembo can merge or close a pull request through GitHub tool calls. If a merge or close action is requested while another Tembo job is already running on that pull request, the agent rejects the request. Wait for the active job to finish, then try again.

> [accordion] Repositories not appearing
>
> Wait 2-5 minutes for initial sync. If they still don't show, click the sync button on the GitHub
> integration card. Check that you granted Tembo access during installation and that you have
> permission to install GitHub Apps for your organization.

> [accordion] @tembo not responding
>
> Make sure you're using `@tembo` (lowercase), that the repository is activated in Integrations, and that your GitHub account is connected to your Tembo account in **Settings > Connected accounts**.

> [accordion] PRs not being created
>
> Check that the repository is activated and there isn't already an open PR for the same issue.


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