The manual.
How to set up Cyboflow and what every part of the cockpit does — the flows, the board, the review queue, sessions, models, and the learning loop.
01What Cyboflow is
Cyboflow is a macOS desktop app for running AI coding flows in parallel against the same project — with you in the loop. Every session works in its own isolated git worktree, so several agents can move at once without stepping on each other or on your working copy. You dispatch the work, the app routes everything that needs your input into one review queue, and nothing lands on your main branch until you merge it.
02The mental model
Five pieces, one loop:
- Projects are local git repos you add to the app.
- Sessions are where work happens. Each session owns an isolated git worktree; runs (flows or chats) nest inside it. Run as many in parallel as you like.
- Flows are multi-step agent workflows — four built-ins (Planner, Sprint, Ship, Compound) plus whatever you build yourself.
- The backlog is a shared board of ideas, epics, and tasks that flows read from and write to — Planner fills it, Sprint drains it.
- The review queue is the single inbox for everything that needs a human: permission requests, decisions, findings, and action items.
The loop: capture an idea → Planner turns it into approved, ready tasks → Sprint (or Ship) executes them in a worktree → you review the diff and merge → Compound mines the finished work for learnings and feeds them back in.
03The guides
Getting started
Prerequisites, install, first launch, and your first flow — download to merged diff.
Read → 02Workflows
The four built-in flows — Planner, Sprint, Ship, Compound — and how to edit or build your own.
Read → 03Backlog & review
The idea / epic / task board, its stages, and the human review queue that gates the work.
Read → 04Sessions & worktrees
Quick sessions, the chat composer, the terminal dock, and reviewing & merging what agents produce.
Read → 05Models & permissions
The model picker, fast mode, per-agent pins, the four permission modes, and SDK vs interactive PTY.
Read → 06Insights & telemetry
Findings triage, run statistics, the code-review eval jury, and what telemetry does (and never does).
Read →