Git Repositories
Overview
Repositories are the starting point for everything in Fly. By connecting your GitHub repositories, you give Fly the context it needs to link artifacts to code, generate meaningful release summaries, and provide full traceability from commit to deployment.
When you connect a GitHub organization, Fly gains visibility into your repositories, watches their workflows, and tracks the artifacts and releases they produce. The connection is established through the GitHub App integration, which you can set up from your coding agent by asking “Start working with Fly” or directly from Fly Web.
How It Works
Connection Model
Fly connects to your GitHub organization via a GitHub App. Once installed, you choose which repositories Fly can access. Fly automatically syncs when you add or remove repositories.
Configuration Status
Each repository has one of two statuses:
Configured – At least one workflow is set up with the Fly action. Artifacts are being tracked, releases are being created, and full traceability is active.
Not Configured – The repository is connected to Fly but no workflows are configured yet. Fly can see it, but it’s not producing artifacts or releases.
What Fly Tracks Per Repository
- Artifacts produced by workflows and local uploads
- Releases from configured workflow runs
- Workflow files and their configuration status
- Links to GitHub source
From Your Coding Agent
The fastest way to connect repositories and configure workflows is through your coding agent. Fly handles the GitHub authorization, scans your workflows, and opens PRs with the required changes.
Connect Your Organization
“Start working with Fly”
Fly walks you through GitHub authorization, connects your repositories, scans your workflows, and opens a PR with CI configuration.
Configure Workflows
“Configure my workflows with Fly”
Fly scans your .github/workflows/*.yml files and opens a pull request with the required changes. Learn more →
Manage Repositories
To add or remove GitHub organizations or repositories after initial setup, use the Manage Org & Repositories button in Fly Web, which redirects to GitHub to manage permissions.
In Fly Web
Fly Web gives your team a visual overview of all connected repositories, their configuration status, and quick access to each repository’s artifacts, releases, and workflows.
Repository List
Navigate to Git Repositories to see all connected repositories from your selected GitHub organization.
| Column | Description |
|---|---|
| Repository Name | Full repository name (org/repo) |
| Status | Configured or Not Configured |
| Last Activity | Most recent artifact or release |
| Artifacts | Number of artifacts and package types |
Repository Details
Click any repository to access:
- Artifacts – Packages and images associated with this repository
- Releases – Complete history of CI/CD runs with AI-generated summaries
- Workflows – GitHub Actions workflow files and their configuration status
Actions
- Configure Workflows – Appears for unconfigured repositories. Opens the coding agent flow or manual configuration
- View on GitHub – Opens the repository on GitHub
- Manage Org & Repositories – Redirects to GitHub to manage which repositories Fly can access
Next Steps
- Artifacts → - Packages and images stored in Fly
- Releases → - AI-generated release summaries
- Workflows → - CI/CD configuration
- Developer Workflow → - Configure your CI