whatisgithub

What is openflow?

travisliu/openflow — explained in plain English

Analysis updated 2026-06-24

15TypeScriptAudience · developerComplexity · 3/5Setup · moderate

In one sentence

A command-line tool that runs multi-step workflows across AI coding agents like Codex and Gemini CLI, letting you chain, parallelize, and pipeline tasks using a single TypeScript workflow file.

Mindmap

mindmap
  root((openflow))
    What it does
      Coordinates AI agents
      Runs multi-step workflows
      Saves run records
    Workflow types
      Sequential tasks
      Parallel tasks
      Pipeline tasks
    Agents supported
      Codex CLI
      Gemini CLI
      Mock provider
    Setup
      npm or npx
      TypeScript workflow file
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run two AI agents in parallel to review a pull request from different angles, then pipe both outputs into a third agent that writes a combined summary.

USE CASE 2

Break a large refactor task into sequential AI coding steps, where each step receives the previous step's output as context.

USE CASE 3

Test a multi-agent workflow locally using the built-in mock provider before running it against real AI API calls.

What is it built with?

TypeScriptNode.jsnpm

How does it compare?

travisliu/openflowceelog/openwereadellismosss/strip-silence
Stars151515
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderatehard
Complexity3/52/52/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires the AI CLI tools you want to run (Codex CLI, Gemini CLI) to be installed and authenticated separately before workflows can execute.

So what is it?

OpenFlow is a command-line tool for running multi-step workflows that involve AI coding agents. There are several AI coding assistants available as terminal commands, such as Codex and Gemini, and OpenFlow sits above them as a coordinator. Instead of running each agent manually one at a time, you write a workflow file that describes what should happen and in what order, then OpenFlow handles the execution. The main use case is breaking a large coding task into stages. For example, you might want two different AI agents to review a pull request in parallel, each looking at different concerns, and then have a third agent summarize both reviews. OpenFlow lets you write that sequence as a TypeScript file and run it with a single command. It tracks which steps finished, captures the output from each agent, and saves a record of the entire run to a local folder so you can inspect what happened. Workflows are written in a constrained subset of TypeScript using a small set of built-in functions: one for running a single agent task, one for running multiple tasks at the same time, one for running tasks in a pipeline, and one for marking named phases. The tool validates workflows before running them, checking that the structure follows its rules and that required metadata like a name and description are present. OpenFlow does not include its own AI model. It calls out to whichever provider CLI tools you have installed locally, such as the Codex CLI or the Gemini CLI. A mock provider is included for testing workflows without making real API calls. The tool is available as an npm package and can be run without a permanent installation using the npx command. It supports options for controlling how many tasks run at the same time, setting timeouts, choosing an output format for use in automated pipelines, and stopping the whole workflow if any single step fails.

Copy-paste prompts

Prompt 1
Write an OpenFlow TypeScript workflow file that runs Gemini and Codex in parallel to review my pull request diff, then summarizes both reviews in a final step.
Prompt 2
I want to use OpenFlow to split a large feature into 3 sequential Codex CLI tasks. Write the workflow file and show me the command to run it.
Prompt 3
How do I run an OpenFlow workflow with a 5-minute per-step timeout and stop-on-failure mode? Show me the full command with all flags.
Prompt 4
Write an OpenFlow workflow that uses the mock provider to test a 4-step pipeline without making real API calls, then show me how to switch it to Gemini.

Frequently asked questions

What is openflow?

A command-line tool that runs multi-step workflows across AI coding agents like Codex and Gemini CLI, letting you chain, parallelize, and pipeline tasks using a single TypeScript workflow file.

What language is openflow written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, npm.

How hard is openflow to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is openflow for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.