GitHub Integration

Interact with Terragon directly from GitHub through app mentions, while Terragon handles PR creation and branch management automatically.

GitHub App Mentions

How It Works

Mention @terragon-labs in GitHub to create new Terragon tasks:

@terragon-labs can you fix the failing tests?

@terragon-labs this method could be optimized using memoization 

What Happens

When you mention Terragon:

Task Creation Behavior

By default, Terragon keeps a single task per pull request or issue. Repeat mentions of @terragon-labs on the same thread are added as follow-up messages so the conversation history stays in one place.

If you want each mention to kick off a fresh task, enable Create new task when @terragon-labs is tagged on GitHub in GitHub & Pull Request Settings. With this toggle on, Terragon always creates a brand-new task—complete with its own sandbox and timeline—whenever you tag the app on GitHub, even if a task already exists for that PR or issue.

This preference applies to your Terragon account across every repository you have access to; it is not configurable per repo. Changing the setting does not modify any existing tasks—those continue exactly as they were when they were created.

Model Selection

The model selected for a github mention is selected based on the following priority:

1. Model specified in the comment (e.g., @terragon-labs [sonnet] ...)
2. Model configured in a "Github Mention" automation (if exists)
3. Your default model specified in GitHub & Pull Request Settings.
4. The last model used in the task (If not creating a new task)
5. Your last selected model in the dashboard.

If an @terragon-labs mention will follow up on an existing task, the first selected model that is valid for the agent will be used. For example, if using Claude Code for a task, specifying @terragon-labs [gpt-5.1] ... will have no effect on the model selected.

Here's a table of how to specify the model for each agent directly in the the github mention comment:

Prompt & Trigger Customizations

You can customize the prompt for a github mention using the "Github Mention" automation. Users on the pro tier can also customize and enable bots to mention @terragon-labs on GitHub to kick off tasks for them.

How Terragon Works with GitHub

Automatic PR Creation

When working on a task, Terragon:

GitHub CLI Access

Every sandbox includes GitHub CLI, allowing Terragon to:

# View PR details and comments
gh pr view 123 --comments

# Check issue information
gh issue view 456

# Understand repository context
gh repo view

Working with Issues

Reference issues in your prompts:

Fix the authentication bug described in issue #234

Terragon will fetch issue details and link the PR appropriately.

Quick GitHub Actions

For tasks with associated pull requests, Terragon provides quick actions directly above the prompt box to help you manage CI workflows:

Fix Failing CI Checks

When your PR has failing GitHub checks, a Fix it button appears that allows you to:

• Automatically create a follow-up message to the agent to address CI failures
• Let the agent investigate and fix the failing tests or checks
• Get your PR back to a passing state quickly

Mark PR as Ready for Review

When your draft PR has all checks passing, a Ready for review button appears to:

• Mark your draft PR as ready for review with one click
• Signal to your team that the changes are ready for feedback
• Move your PR forward in the review process

These actions help you move faster by reducing context switching between Terragon and GitHub.

Having issues with GitHub integration? See our Troubleshooting guide for solutions to common problems.

For information about security and permissions, see our dedicated Security & Permissions page.