GitHub Integration

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

GitHub App Mentions

To mention @terragon-labs on GitHub, you must grant Terragon access to the repository you're tagging it in. You can do this in Settings, the repository selector in the prompt box, or in Environments.

How It Works

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

@terragon-labs can you fix the failing tests?

text @terragon-labs implement the feature described above

@terragon-labs this method could be optimized using memoization

What Happens

When you mention Terragon:

Terragon immediately reacts with a 👀 emoji to acknowledge your request

A new task is created automatically

Terragon receives full context about the PR/issue and your comment

Work begins in an isolated sandbox

You'll see the task appear in Home

How Terragon Works with GitHub

Automatic PR Creation

When working on a task, Terragon:

Creates a new branch with your changes

Commits with descriptive messages

Opens a pull request with:

Comprehensive description
Test plan checklist
Co-author attribution to Terry
Links to Terragon task

GitHub CLI Access

Every sandbox includes GitHub CLI, allowing Terragon to:

GitHub CLI Examples

# 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.

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.