Repositories

Repositories are the git codebases your project works against. Connecting a repository to a project lets AI agents read the codebase, commit changes, and open pull requests as part of workflow automation.

Connecting a repository

1. Go to Project Settings > Repositories and select Add Repository.
2. Enter the repository URL. Fluxlix supports any git-compatible host (GitHub, GitLab, Bitbucket, self-hosted).
3. Provide credentials if the repository is private. Credentials are stored encrypted and used only for repository operations.
4. Optionally set a default branch — the base branch agents will use when creating feature branches and pull requests.
5. Select Save. Fluxlix will verify the connection before saving.

Repository fields on work items

Once a repository is linked to a project, it becomes available as a metadata field value on work items. You can configure your project's metadata schema to include a repository selector, a branch selector, or both — so each work item can track exactly which repository and branch it relates to.

Branch management

Fluxlix does not manage branches directly, but workflows can create and switch branches as part of their execution. When an agent workflow runs, it typically:

1. Checks out the default branch of the linked repository
2. Creates a new feature branch named after the work item
3. Commits changes to the feature branch
4. Opens a pull request targeting the default branch

The branch naming pattern is configurable within your workflow nodes.

Updating credentials

If your repository credentials change (for example, after rotating a deploy key), update them in Project Settings > Repositories by editing the repository entry. The previous credentials are replaced immediately.

Removing a repository

Removing a repository from a project disconnects it from future workflow runs but does not delete any history or work items that referenced it. Existing pull requests and commits are unaffected.

Next steps

• Projects — Configure other project settings
• Agent Workflows — Build workflows that use repository operations
• Metadata Fields — Add a repository or branch field to your work items