GitHub Integration

Connect your GitHub repositories to enable agents to read code, create issues, and submit pull requests.

Prerequisites

Before connecting GitHub, ensure you have:

  • GitHub CLI (gh) installed and authenticated
  • Git installed on your machine
  • Repository access - write access for PR creation

Installing GitHub CLI

# macOS
brew install gh

# Windows
winget install GitHub.cli

# Linux (Debian/Ubuntu)
sudo apt install gh

# Arch Linux
sudo pacman -S github-cli

Authenticating

gh auth login

Follow the prompts to authenticate with your GitHub account.

Connecting a Repository

  1. Open your team in Operum
  2. Go to Team Settings
  3. In the GitHub section, enter your repository URL
  4. Click "Connect"

Supported URL formats:

https://github.com/username/repo
git@github.com:username/repo.git
username/repo

What Agents Can Do

With GitHub connected, agents can:

Read Operations

  • Browse repository files
  • Read issue details
  • View pull request changes
  • Check workflow status

Write Operations

  • Create branches
  • Commit changes
  • Open pull requests
  • Comment on issues

Agent-Specific Usage

Engineer Agent

Creates feature branches, implements code, and opens PRs:

Create a PR that adds user authentication using NextAuth.js

Architect Agent

Reviews code structure and comments on issues with recommendations:

Review issue #42 and suggest an implementation approach

Tester Agent

Checks out PRs, runs tests, and reports results:

Test PR #15 and report any issues

Security

Operum uses your local GitHub CLI credentials. No tokens are stored in Operum - all authentication happens through gh.

Tip: Use GitHub's fine-grained personal access tokens if you want to limit agent permissions to specific repositories.

Troubleshooting

Authentication Issues

# Check auth status
gh auth status

# Re-authenticate if needed
gh auth login

Permission Denied

Ensure you have write access to the repository. For organization repos, you may need to request access from an admin.