Premia
Getting started

Connect GitHub

Install the Premia GitHub App so Premia can read code and open PRs.

Premia works through a GitHub App you install on your repositories. The App grants the minimum access needed to read code, create branches, and open pull requests.

Settings → Integrations — GitHub and Linear connected, each with reconnect and disconnect controlsSettings → Integrations — GitHub and Linear connected, each with reconnect and disconnect controls

Install the app

From Settings → Integrations, click Connect GitHub and choose the repositories (or the whole org). You can change the selected repos at any time from GitHub.

Pick repos for a project

Each project connects one or more repos from Project settings → Repos → Add repo. The list is fetched live from GitHub each time you open it, so a repo you just created or granted the App access to shows up right away. When a ticket comes in, the Planner decides which of the connected repos need changes and fans out work to each.

Permissions

The GitHub App requests read/write on contents and pull requests for the repos you select. Premia never gets access to repos you don't grant.

Webhook events

Premia keeps its repo list current from the App's webhooks. The App subscribes to the Repository event (repos created, renamed, transferred, or deleted) as well as installation repository changes. With All repositories access, GitHub only reports a newly created repo through the Repository event.

Re-syncing

If you add repos in GitHub and don't see them in Premia, click Refresh in the Add repo menu (or run premia repos list from the CLI to confirm what's connected). If GitHub has suspended or removed the App installation, the menu asks you to reconnect GitHub from Settings → Integrations. Repos you remove from the App's access stay attached to their projects and reappear in the list if you grant access again.

On this page