vibe-flow OSS launch
GitHub Run it

An 8‑agent autonomous product team that ships through a 10‑stage pipeline.

vibe-flow is a monorepo of OpenClaw extensions, skills, and quality tooling. It runs a full product team — with a virtual office, quality gates, and pipeline orchestration — taking ideas from chat to merged PRs.

8
agents
10
pipeline stages
6
extensions
Quick start Star on GitHub

No frameworks. No build step. Mermaid diagrams. System fonts.

Why developers care
  • Role clarity: PM → PO → TL → Design → Dev → QA → Review → Shipping.
  • Guarded state machine: transitions require evidence, not vibes.
  • Auditability: decisions, events, and outcomes are logged.
  • Composable architecture: 6 extensions, clean responsibility split.
  • Virtual office: watch agents work in real time via SSE dashboard.
Virtual office dashboard showing 8 agents working through a pipeline task in real time
Live agent activity — virtual office dashboard

Key features

What you get when you run vibe-flow with OpenClaw.

Evidence‑driven workflow

Stages advance only when required evidence is present (tests, lint, QA report, review result).

Safe tool surface

Each agent uses a strict allow‑list: tasks, workflow, quality, decisions, messaging, and pipeline tools.

Quality gate engine

Parse artifacts (Vitest/ESLint/coverage/complexity) and evaluate a policy with alerting + auto‑tuning.

Human‑supervised autonomy

Status updates route to chat so humans can supervise outcomes without micromanaging execution.

Docs

Start here if you’re evaluating or contributing.

In action

The 8-agent team running through a real pipeline.

OpenClaw dashboard showing the 8-agent roster with model routing
Agent roster & model routing
Pipeline status updates flowing through agent chat
Pipeline updates in chat
Quality gate summary with coverage, lint, and complexity results
Quality gate summary

Roadmap

20 epics across 4 axes: Intelligence, Communication, Scale, Distribution.

SHIPPED EP01-EP09: Foundation through Pipeline Orchestration
SHIPPED EP10-EP12: Dynamic Model Routing, Budget Intelligence, Learning Loop
SHIPPED EP13-EP15: Stable Protocol, Observability, Telegram Control Plane
SHIPPED EP20: Virtual Office (live agent dashboard)
PLANNED EP16-EP17: E2E Testing, Security Hardening
PLANNED EP18-EP19: SDK Contracts, Documentation, Showcase
Call to action
If you like the idea of a product team that can ship while you sleep, star the repo and follow along.
View on GitHub Run locally

Install / Quick start

Clone the repo and run with Docker. No web framework required.

Clone

Shell 
git clone https://github.com/Monkey-D-Luisi/vibe-flow
cd vibe-flow

Run (Docker)

Shell 
cp .env.docker.example .env.docker
# edit .env.docker
docker compose build
docker compose up -d

docker exec openclaw-product-team pnpm exec openclaw models list
docker exec openclaw-product-team pnpm exec openclaw doctor

Docs: docker-setup.md

What you get

  • Control UI: http://localhost:28789/
  • 8 agents + 6 extensions loaded
  • Chat integration for human oversight
  • Quality gate CLI for local/CI validation

The 10‑stage pipeline

A predictable assembly line: each stage produces evidence that unlocks the next.

Stages

1IDEA
2ROADMAP
3REFINE
4DECOMP
5DESIGN
6BUILD
7QA
8REVIEW
9SHIP
10DONE

Each stage can post updates back to chat — so humans can supervise without micromanaging.

Guarded transitions
The task lifecycle is a state machine. Some transitions are guarded and require metadata evidence.

Task state machine (transition guards)

stateDiagram-v2 backlog --> grooming grooming --> design grooming --> in_progress : fast-track (minor) design --> in_progress : requires architecture_plan in_progress --> in_review : requires dev_result in_review --> qa : requires review_result in_review --> in_progress : rejection loop qa --> done : requires qa_report qa --> in_progress : rework loop

Source: transition-guard-evidence.md

6 extensions, one cohesive runtime

This landing page is just static files — but the system behind it is modular and composable.

product-team

Task engine, workflow, quality, VCS automation, decision engine, pipeline orchestration.

quality-gate

Standalone quality engine + CLI for local and CI runs.

telegram-notifier

Lifecycle → chat notifications & routing.

model-router

Per-agent model routing via config + hooks.

stitch-bridge

Bridge to Google Stitch MCP for design tooling.

virtual-office

Live office visualization with agent activity tracking and SSE.

Integration topology

flowchart LR OC[OpenClaw Gateway] --> PT[product-team] OC --> MR[model-router] OC --> TN[telegram-notifier] OC --> SB[stitch-bridge] OC --> VO[virtual-office] CI[Local/CI shell] --> QG[quality-gate CLI] PT --> Tools["38 tools: task / workflow / quality / vcs / team / decision / pipeline"] PT --> DB[(SQLite DB)] SB --> Stitch[Google Stitch MCP] VO --> SSE[SSE dashboard]