Flows
- Tier: Premium, Ultimate
- Add-on: GitLab Duo Core, Pro, or Enterprise
- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
- Status: Beta
The availability of this feature is controlled by a feature flag. For more information, see the history.
A flow is a combination of one or more agents working together to solve a complex problem.
GitLab provides two types of flows:
- Foundational flows are pre-built, production-ready workflows created by GitLab for common development tasks.
- Custom flows are workflows you create to automate your team’s specific processes. You define the workflow steps and agents, and define triggers to control when the flow runs.
Flows are available in IDEs and the GitLab UI.
- In the UI, they run directly in GitLab CI/CD, helping you automate common development tasks without the need to leave your browser.
- In IDEs, the software development flow is available in VS Code, Visual Studio, and JetBrains. Support for other flows is being proposed.
For more information about how flows execute in CI/CD, see the flow execution documentation. For information about the security of flows, see the composite identity documentation.
Prerequisites
To use flows:
- You must meet the prerequisites.
To execute flows in the GitLab UI:
- You must turn on flows with the GitLab Duo settings.
- Before you add or execute a flow for the first time, you must allow members to be added to the group your project is in.
- To use flows that create code, you must configure push rules to allow a service account.
Monitor running flows in the GitLab UI
To view flows that are running for your project:
- On the top bar, select Search or go to and find your project.
- Select Automate > Sessions.
View flow history in the IDEs
To view a history of flows you’ve run in your project:
- On the Flows tab, scroll down and view Recent agent sessions.
Customize flows with AGENTS.md
Use AGENTS.md files to provide context and instructions for GitLab Duo to follow while executing
foundational and custom flows.
For more information, see AGENTS.md customization files.
Give feedback
Flows are part of GitLab AI-powered development platform. Your feedback helps us improve these workflows. To report issues or suggest improvements for flows, complete this survey.