Docs / Repositories

Connecting a GitHub repository

From the Repositories page, choose GitHub as your provider and Create and track PR/MR as the delivery style — this is the only combination that can currently execute a real job. You'll be sent to GitHub to install the CustomerShip App on the specific repository (or repositories) you want to connect; CustomerShip never asks for org-wide admin access.

Once connected, CustomerShip automatically analyzes the repository — file counts, languages, rough size — to build a lightweight map of it. This runs on connect and doesn't cost any doubloons; it's what makes later estimates and edits cheaper and more accurate than starting from nothing.

What CustomerShip can and can't do with this access

• It can read your repository's contents and open pull requests against your default (or chosen) branch.
• It never pushes directly to a branch without opening a PR, and never force-pushes.
• It never merges a PR on your behalf — that's always your decision.

Plan limits

Free lets you connect one repository to one app. Paid plans raise both the repository and app limits.

GitLab

GitLab support is planned but not available yet — the connection wizard shows it as disabled with a "coming soon" note you can subscribe to.