Mermaid Flow: the visual builder for agentic workflows

• 4 mins

Mermaid Flow lets you build agentic workflows as diagrams and run them the same way every time. Why we made it, and four workflows to start with.

Today we’re launching Mermaid Flow, which lets you build agentic workflows as diagrams and then run them. We made it for the AI work that happens more than once, so you can build something a single time and trust it to run the same way every time after that.

Most teams already have work like this. Someone triages the new issues, someone else writes the weekly recap, and someone gives each PR a first read before a reviewer gets to it. A lot of that work now runs through AI, and most of it lives in a chat window or a prompt file, where you can see what goes in and what comes out but nothing in between.

Flow puts the in-between on the page. You lay the workflow out as steps in a diagram, connect the tools it needs, and run it. The steps stay the same on every run, no matter who presses run, and everyone on the team can see them.

Why we made Flow

We kept seeing repeated AI work end up in places that were built for one-off work.

A chat window is a great place to figure something out, but it’s a hard place to keep something you do every Monday. The prompt gets pasted from a doc, adjusted a little, and run again. Over time the output drifts, and nobody can quite say why, because there is nothing to compare it against. Each teammate ends up keeping their own copy, and “how we triage issues” quietly becomes five slightly different prompts.

The usual fix is to write a script or wire up an automation tool. That does work, but it also moves the work somewhere most of the team can’t read. The person who knows how triage should go and the person who can edit the pipeline are often two different people.

All of this kept bringing us back to something we already knew. Our team maintains the open-source Mermaid project, and for years we’ve watched people use it to draw how a process is supposed to work. Often that diagram was the clearest description of the process anyone had, and the only thing missing was that it couldn’t actually do anything.

In Flow, it can. The picture you would draw to explain the work to a new teammate is now the thing that runs. Four ideas came out of that, and together they explain what Flow does and what we chose to leave out.

  • The steps are fixed. Flow runs the same steps in the same order each time. The model still does the thinking inside each step, but it doesn’t get to decide what the steps are.
  • You can see the middle. Every step between the input and the output is on the page, so when a result looks off, you know where to look.
  • There is one copy. Anyone on the team can read the workflow, and anyone who runs it gets the same steps as the person who built it.
  • Setup isn’t the project. You pick the work, connect your tools in one click, and run it. We know that if building a workflow takes longer than doing the task by hand a few more times, nobody will build it.

Where to start

The best first workflow is something you did this week and expect to do again next week. Here are the four we see most often, each small enough to build in minutes.

  • Triage every issue. When a new issue comes in, Flow reads it, applies the labels you already use, checks for duplicates, and sends it to the right owner. A good way to start is to write down the labels and routing rules your team follows today, including the ones that only live in someone’s head.
  • Recap the week. Schedule this one for Friday afternoon. Flow gathers what shipped, what is still open, and what is blocked, then posts the summary wherever your team already reads updates. Start with last week’s recap and work backward to where each line came from.
  • Give every PR a first read. Before a reviewer opens it, Flow summarizes the change, checks it against your own review checklist, and flags the parts that need a person. Start with the three comments your team leaves most often.
  • Draft the release notes. Flow collects the work merged since the last release, groups it, and writes a draft in your format for someone to edit. Start with the last set of notes you were happy with.

Mermaid Flow is available now at mermaid.ai/flow. The free plan includes 15 workflow runs a month, which is enough to see one of your own workflows work, and Premium includes 500 shared runs a month across your organization. Learn more here.

We’re also on Product Hunt today. If you build something, come tell us what it was.