Prerequisites
Before installing FlowDeck CLI, ensure you have:1
Recent macOS running on an Apple Silicon or Intel Mac
- macOS 13 (Ventura) or higher
2
Xcode
FlowDeck uses Xcode’s internal tools to build and debug your apps.
- Download from the Mac App Store (16.0 or later)
- Launch Xcode at least once to install components
- Accept the license agreement
3
Xcode Command Line Tools
Install the latest command line tools
Installation
Run this command in your terminal:~/.local/bin by default. If this directory is not in your PATH, it will provide a command to add it.
Verify Installation
After installation, verify FlowDeck CLI is working:License Activation
Standalone terminal use normally requires a valid CLI license. A license is valid for two (2) machines. During the FlowDeck macOS beta, protected CLI commands also work without a separate CLI license when the production beta service is active and/Applications/FlowDeck.app reports a version below 1.0.0. This applies to standalone terminal commands as well as commands launched by the app. Apps installed under another name or location do not enable this beta access.
Activate Your License
Check License Status
CI/CD Usage
Using your license as an environment variable does not count against your license limit, but the functionality is restricted to CI/CD environments only (GitHub Actions, GitLab CI, CircleCI, Jenkins, etc.).
Next Steps
Once installed, try these commands:Check the Command Reference for complete documentation of all available commands.