Repositories

How to link GitHub repositories to your PropellerDeck organization and products, including webhook setup for automatic notifications.

Repositories

PropellerDeck connects to your GitHub repositories so that your AI agents and team members have access to your codebase, pull requests, and commit activity. Repositories are scoped to Products, so each product has its own set of linked repos.

Linking a Repository

To link a GitHub repository to a product:

  1. Open the Organization Dashboard at /orgs/<org_id>/.
  2. Click Repositories in the left navigation.
  3. Click Link Repository.
  4. Authenticate with GitHub if prompted, then select the repository you want to link.
  5. Choose the Product this repository belongs to.
  6. Click Save.

The repository now appears in the Repositories list and is accessible to agents and team members working within that product.

Webhook Setup

PropellerDeck can receive automatic notifications when your team pushes code or opens pull requests. During repository setup, you will see an option to Install Webhook. Enabling the webhook allows PropellerDeck to:

  • Notify your team of new commits and pull requests in real time
  • Give AI agents up-to-date context about recent code changes
  • Trigger workflows based on repository events

To install the webhook, click Install Webhook next to a linked repository and follow the GitHub authorization prompt.

Repository Scope

Each repository is linked to a specific product rather than to the organization as a whole. This keeps large organizations tidy — team members working on one product do not see repositories for unrelated products. If a repository is relevant to multiple products, you can link it to each product separately.

For more about connecting GitHub to PropellerDeck, see GitHub Integration.