Prerequisites
Before installing, make sure you have:1
macOS on Apple Silicon
- Apple Silicon Mac (M1 or later)
- macOS 26 (Tahoe) or later
Support for macOS 15 (Sequoia) is temporarily suspended. We are working to
restore it in an upcoming release.
2
Xcode
- Download from the Mac App Store (26 or later)
- Launch Xcode at least once to install components and accept the license agreement
3
Xcode Command Line Tools
Download FlowDeck
Download FlowDeck from flowdeck.studio Move the app to your Applications folder and launch it.Activate FlowDeck
FlowDeck needs a license to open. On first launch it offers a 14-day trial; if you already have a key, choose Already have a license? and paste it. The app accepts a FlowDeck Studio or FlowDeck for Teams license. A FlowDeck CLI license is a different product and does not unlock the app — paste one and FlowDeck names the product your key is for rather than calling it invalid. Your license lives in one place on the machine and is shared with the FlowDeck CLI: activating in the app licenses the CLI too, and vice versa. One machine uses one seat. Manage it in Settings ▸ License, which shows the plan, status, renewal date, and how many seats are in use. Manage License opens the license portal; Remove License releases the seat on this machine — including for the CLI.Open a Project
Choose File → Add Project… (⌘O). The sheet offers three sources:- New App — scaffold a new application from scratch
- Local folder — open an existing
.xcodeprojor.xcworkspacefrom your Mac - GitHub — clone one of your repositories
Next Steps
The AI Agent
Learn what the built-in agent can do and how to talk to it effectively.
Build & Run
Build and run your first app from FlowDeck.