Connect repositories
From the dashboard
If you skipped repository import during onboarding, or want to add more repositories:
GitHub repositories
If you signed up with GitHub or connected your GitHub account:
- Select GitHub as the provider
- CodeStax fetches all repositories you have access to (including organization repos)
- Search and select the repositories you want to import
- Click Import & Scan
CodeStax requests the following GitHub permissions:
read:user- Read your profileuser:email- Access your emailrepo- Read repository contents for scanning
GitLab.com repositories
If you signed up with GitLab or connected it from Integrations:
- Select GitLab as the provider.
- CodeStax loads projects visible to the connected GitLab.com account, including group projects allowed by the token.
- Select projects and click Import & Scan.
GitLab merge-request reviews, summary notes, inline discussions, and commit-status delivery use the same connected GitLab.com identity when the required project permissions and webhook are present.
Bitbucket repositories
If you signed up with Bitbucket or connected your Bitbucket account:
- Select Bitbucket as the provider
- CodeStax fetches your Bitbucket repositories and workspaces
- Select repositories and click Import & Scan
CodeStax requests the following Bitbucket permissions:
account- Read your profilerepository- Read repository contentsemail- Access your email
Repository management
Once imported, each repository card shows:
- Provider icon (GitHub, GitLab, or Bitbucket)
- Repository name
- Last scan status - Queued, In Progress, Completed, or Failed
- Last scan time - Relative timestamp
Available actions
| Action | Description |
|---|---|
| Scan | Trigger a new scan (choose Smart or Deep) |
| Delete | Remove the repository from CodeStax (with confirmation) |
Auto-scan on push
When auto_scan_on_push is enabled under Settings → General and a GitHub or Bitbucket push webhook is installed, a push to the tracked default branch triggers a scan. GitLab merge-request webhooks drive PR reviews; GitLab push-to-scan is not currently implemented.
Repository limits
The number of repositories you can import depends on your plan:
| Plan | Max Repositories |
|---|---|
| Free | 1 |
| Growth | 10 |
| Pro | Unlimited |
| Enterprise | Unlimited |
If you hit your limit, you’ll be prompted to upgrade your plan or remove existing repositories.