Local-first · Zero runtime dependencies · MIT

Orchestrate AI coding engines
with guardrails.

VibeFlow is a local-first CLI and web UI that drives Claude Code, Codex, and GitHub Copilot CLI as an orchestrator — with engine preflight, git source protection, work-unit orchestration, and verification built in.

npx @magicpro97/vibeflow
View on GitHub npm package

What it does

Multi-engine, out of the box

Drive Claude Code, OpenAI Codex CLI, and GitHub Copilot CLI from one orchestrator with shared context and instruction files generated per engine.

Source protection

A git checkpoint before every real dispatch: clean-tree gate, opt-in --auto-wip snapshot, and one-command rollback so an engine run never loses your work.

Engine preflight

Probe each engine for presence, auth, and a live round-trip before dispatch. Workflows only start when an engine actually works — no silent dead ends.

Work-unit orchestration

Decompose a task into non-overlapping work units, dispatch them in parallel, and gate completion on a confidence check with recorded evidence.

Universal guardrails

Hooks score every action and block destructive commands, secret reads, and out-of-scope writes — natively on Claude, detection-only with a banner elsewhere.

Skills & code-nav tools

Capability-matched skills plus optional codegraph and LSP navigation, wired as MCP servers with a codegraph > lsp > native priority ladder.

How it works

  1. vf init

    Scan the repo and generate canonical context + per-engine instruction files.

  2. vf doctor --probe

    Confirm an engine is installed, authenticated, and responding before any work.

  3. vf orchestrate --yes

    Checkpoint the tree, dispatch work units in parallel, and review each result.

  4. vf verify

    Run typecheck / lint / test plus confidence, evidence, and scope gates.

From install to first check