qflow

What it is

Qflow gives AI coding agents (Claude Code, Codex, ...) a language and system to author video. Drop in a reference video and your agent turns it into a complete, editable workflow — footage, captions, B-roll, motion graphics — all anchored to words instead of seconds. One command reruns the whole film, or a hundred variants of it.

Generation models are optional: a workflow can compile captions, code-rendered visuals and local media into a finished video without calling any generation service.

Related MCP server: Funplay MCP for Unity

Install

npx skills add Pangu-Immortal/qflow -g

Requires Node.js 22.15+. Your agent checks for the Qflow executable on first use and helps prepare it. Video projects live anywhere; the CLI and the agent skill share the same SVML sources.

Use

Give the /qflow skill a video to clone, or describe the video you want:

/qflow Clone this video: /path/to/video.mp4, and replace the ranking content with my product.
/qflow Make a ranking video that puts my product in S tier.

From a terminal, the same sources drive the CLI directly:

qflow plan <run.svrun> --runtime <profile.json>   # check what a Run will do
qflow build <run.svrun> --runtime <profile.json>  # execute it end to end
qflow studio --run <run.svrun>                    # live preview while you edit

Output location

Finished deliverables are exported to the project root output/ directory — the single delivery location for people and downstream tools. qflow get writes exactly where --to points, so run it from the project root:

qflow get <build-id> --output final.video --to output/final.mp4

Intermediate Build data lives in .qflow/results/ and is never a delivery artifact. Archived or superseded exports go under output/archive/.

Credentials stay out of the repository: runtime profiles reference credential stores (such as the environment-variable store) and never embed secrets.

Examples

Docs

• Quickstart

• Guide — architecture, packages, conventions, testing

• Skill reference — the full agent skill

License

Apache-2.0 with additional conditions — see LICENSE.