Getting started.
Download to first merged diff. If you already run Claude Code, this takes about five minutes.
01Prerequisites
- macOS 13 Ventura or later, Apple Silicon or Intel.
- Claude Code, installed and authenticated. Cyboflow drives Claude through your existing Claude Code login — there is no separate API-key field. A Max plan works best.
- A local git repo to point it at — or an empty directory; Cyboflow will create it and initialize git for you.
02Install
Grab the DMG for your architecture from the download page and drag Cyboflow into /Applications. Builds are Developer ID-signed and Apple-notarized, so Gatekeeper opens them without ceremony.
- Apple Silicon (M1–M4) → the ARM64 build. Recommended for most Macs.
- Intel → the x64 build.
Not sure which? Apple menu → About This Mac → check the Chip line. Once installed, the app keeps itself current — updates download in the background and apply on restart (Settings → Updates).
03First run
-
Create or select a project
On first launch the Welcome screen walks you through it: point Cyboflow at an existing git repo, or at a new directory and it will create it and initialize git.
-
Start a session
Pick a flow from the picker — Planner to turn an idea into a backlog, Sprint to execute ready tasks, Ship for both in one run — or hit Quick Session to just chat with Claude against your repo. Either way the session gets its own isolated git worktree, so your working copy is never touched.
-
Stay in the loop
Cyboflow pauses Claude whenever it needs to take an action. Approvals, decisions, and findings from every running agent land in Human review — navigate with j/k, decide with y/n.
-
Ship the result
When a run finishes, review its changes in the Diff panel, then merge the worktree back to main (squash or preserve history), open a PR, or dismiss the session and main is untouched. Merging a sprint moves its tasks to Done.
04How auth works
Cyboflow bundles the Claude Agent SDK, so the default (SDK) runtime needs nothing on your PATH — it authenticates through the credentials your Claude Code login already established. You never paste a key into the app.