DocsConnect your tools

Connect a repository to a project

Branches, commits and pull requests on every ticket, issues to and from the repository, and Helpi Agent in your code.

Updated 22 November 2026

Connect a GitHub or GitLab repository to a project and every ticket shows the branches, commits and pull requests that name it. Issues can come in from the repository or go out to it, and Helpi Agent can work on tickets in your code.

Connect with a token

  1. Open the project's Repository page and click Connect Repository.
  2. Choose the provider: GitHub or GitLab.
  3. Paste the repository's address, like https://github.com/acme/app.
  4. Paste a personal access token from your GitHub or GitLab settings.
  5. Click Connect Repository. Octopora checks the token against the repository and says when it is connected.

github.com and gitlab.com are supported. A project has one repository; connecting another replaces it.

The access a token needs

TokenTo read activityFor Helpi Agent to push and open pull requests
GitHub, fine-grainedContents and Pull requests: readContents: write and Pull requests: write
GitHub, classicreporepo
GitLabread_apiDeveloper role, api and write_repository

The Helpi GitHub app (optional)

With a GitHub repository connected, Settings > Helpi Agent > Repository offers Install the Helpi GitHub app. Install it on the same repository: from then on, pull requests, commits and comments appear under the app's own name instead of a person's.

Name your work after the ticket

Put the ticket's key anywhere in a branch, a commit message or a pull request title and it shows on the ticket. Each ticket's Git Workflow card has examples to copy.

WhatExample
Branchfeature/ML-13-login-screen
CommitML-13: add the login form
Pull request[ML-13] Login screen
  • Case does not matter, and ML-1 does not match ML-10.
  • On GitLab, pull requests are merge requests; the same names work.
  • If your repository uses another prefix, like CP-12 for ML-12, enter it in Settings > General > Git key prefix.

Issues

On the Issues page, Import GitHub Issues (or GitLab) lists the repository's issues to bring in: open ones arrive as Opened, closed ones as Resolved. From an issue's menu, Push to GitHub issue creates it in the repository.

Disconnect

On the Repository page, click Disconnect. The connection and its token are removed; you can connect again later. Helpi Agent then asks for a repository before it can run.

Questions

Helpi Agent says the token cannot push.

The token cannot write. Create one with the write access above and click Reconnect repository.

A branch does not show on its ticket.

Check that the key is in the branch, commit or pull request title, and that a renamed key is set as the Git key prefix.

Can I connect a self-hosted GitLab?

Not yet: github.com and gitlab.com only.

Watch the tourThe repository module in a minute.