Loopflow

Loopflow helps you maintain flow and craft using coding agents (Claude Code, Codex, Gemini CLI) at high scale.

Loopflow helps you create and run Waves. Waves are chains of coding agents working together in pre-defined ways.

Waves are first built manually through more interactive exploration. Eventually waves become autonomous through looping, scheduling, and watching for changes.

Waves

Waves are objects with 4 primary fields.

Steps

lf debug -c    # paste an error, watch it fix
lf design      # interactive design session

Steps are prompts that run coding agents. Add your own in .lf/steps/.

Planning steps (plan/)

Code steps (code/)

Interactive steps (interactive/)

Ops steps (ops/)

Flows

lf design && lf implement && lf gate    # chain steps manually
lf flow ship                            # or use a named flow

Steps chain into flows. Flows feed into waves.

Code flows (code/)

Plan flows (plan/)

Forks

Forks run a step in parallel with different directions, then synthesize the results.

lf flow roadmap-reduce    # runs reduce 3x with different perspectives

roadmap-reduce forks reduce across infra-engineer, designer, and product-engineer directions, then synthesizes and publishes to roadmap.

Playing in the Waves

Once you have played with chaining steps into flows, you're ready to start running waves.

lfq create engbot .                # create a wave
lfq run engbot                            # start a wave

Configure flow/area/direction with loopflow.update_wave(...), then start it with loopflow.run_wave(...).

python - <<'PY'
import loopflow.api as loopflow

loopflow.update_wave("engbot", flow="ship", direction=["designer"], area=["designs/"])
loopflow.run_wave("engbot")
PY

You can compose multiple directions to add additional nuance or perspectives.

lf review -d designer,product-engineer
lf review -d ceo

Install

curl -fsSL https://github.com/loopflowstudio/loopflow/releases/latest/download/install.sh | sh

Built-in steps and flows included. lf init sets up your coding agent and preferences.

cargo install --git https://github.com/loopflowstudio/loopflow --bin lf --bin lfd

Install the Rust binaries directly with cargo.

Query lfd (lfq)

uv tool install loopflow
lfq                  # status overview
lfq list             # list waves
lfq logs engbot      # tail agent output

uv tool install loopflow installs the Python CLI (lfq) and Python API only.
Use the install script or cargo to install lf and lfd.

Python API

uv pip install loopflow

import loopflow.api as loopflow

loopflow.waves()
loopflow.create_wave("engbot", repo=".", flow="ship", direction=["product-engineer"])
loopflow.run_wave("engbot")

Documentation →

Integrations

Coding Agents

• Claude Code — Anthropic's coding agent (default)
• Codex CLI — OpenAI's coding agent
• Gemini CLI — Google's coding agent

Skill Libraries

• superpowers — prompt library (lf sp:<skill>)
• SkillRegistry — remote skill directory (lf sr:<skill>)
• rams — accessibility and visual design review

Requirements

• macOS
• Claude Code, Codex, or Gemini CLI

License

MIT