Flows
- Tier: Premium, Ultimate
- Add-on: GitLab Duo Core, Pro, or Enterprise
- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
- Status: Beta
Model information
- LLM: Anthropic Claude Sonnet 4
Version history
- Introduced as a beta in GitLab 18.3 with a flag named
duo_workflow. Enabled by default. - Additional flags are required for foundational flows.
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 flows executing in CI/CD, see the flow execution documentation.
For more focused pieces of work, like understanding selected code, use GitLab Duo Chat (Agentic).
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.
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.