Repository Management
Repositories are automatically imported when you install the recommit GitHub App. This section covers how to manage, enable, and configure your repositories.
How Repositories Are Added
Repositories are added through the GitHub App installation process:
- Install GitHub App - Select which repositories to authorize
- Automatic Import - recommit syncs repository information
- Ready to Configure - Enable and link to a roadmap
You don't manually add repositories. They're automatically imported based on your GitHub App permissions.
Repository List
Navigate to Console → Repositories to view all imported repositories.
Each repository displays:
| Field | Description |
|---|---|
| Name | Repository name (e.g., my-library) |
| Full Name | Full path (e.g., org/my-library) |
| Status | Current state (Normal, Suspended, Disabled) |
| Roadmap | Linked roadmap (if any) |
| Default Branch | The repo's default branch (e.g., main) |
Repository Status
| Status | Description | Cherry-pick? |
|---|---|---|
| Normal | Repository is active and enabled | ✅ Yes |
| Suspended | GitHub App access is suspended | ❌ No |
| Disabled | Manually disabled by user | ❌ No |
Filtering Repositories
Use filters to find specific repositories:
- By Status - Show only Normal, Suspended, or Disabled repos
- By Roadmap - Show repos linked to a specific roadmap
- By Name - Search by repository name
Quick Actions
From the repository list, you can:
- Enable/Disable - Toggle auto cherry-pick
- Link Roadmap - Associate with a roadmap
- View Details - See full configuration
Syncing Repository Info
recommit automatically syncs:
- Default branch name
- Squash merge settings
- Repository description
If information seems outdated, repository data syncs automatically when:
- A webhook event is received
- You visit the repository settings
Removing Repositories
To remove a repository from recommit:
- Go to GitHub Settings → Applications → recommit
- Click Configure
- Remove the repository from authorized list
- recommit will automatically remove it
⚠️
Removing a repository does not delete historical cherry-pick records.
Next Steps
- Enable Repository - Turn on auto cherry-pick
- Link Roadmap - Connect repository to a roadmap
- Cherry-Pick History - View past cherry-picks