Skip to main content
FlowDeck CLI is a standalone command-line tool for building, running, and testing iOS/macOS applications without leaving your terminal. It provides a streamlined development experience for developers who prefer working from the command line or need to integrate Xcode builds into CI/CD pipelines.

​
Why FlowDeck CLI?

Terminal-First

Build, run, and test directly from your terminal without switching to Xcode

CI/CD Ready

JSON output mode for easy integration with automation pipelines

AI Agent Compatible

Designed to work seamlessly with Claude Code and other AI assistants

Fast Iteration

Optimized builds with intelligent caching and parallel compilation

​
Key Features

  • Build & Run - Compile and launch iOS/macOS apps on simulators or devices
  • Test Execution - Run unit and UI tests with detailed results
  • Simulator Management - Boot, shutdown, and manage iOS simulators
  • Device Support - Deploy and run on physical Apple devices
  • Log Streaming - Real-time OSLog streaming from running apps
  • JSON Output - Machine-readable output for automation and AI agents
  • Project Discovery - Auto-detect workspaces, schemes, and build configurations

​
Requirements

FlowDeck CLI requires macOS with Xcode installed. It does not support Windows or Linux.
  • macOS 13.0 or later
  • Xcode 15.0 or later (with command line tools)
  • Apple Silicon Mac: M1 or later recommended for best performance

​
Quick Start

# Install FlowDeck CLI
curl -sSL https://flowdeck.studio/install.sh | sh

# CD to your macOS or iOS project
cd ~/myApp

# Start FlowDeck's interactive mode
flowdeck -i

# Check available Commands
Press 'H' for help on the available commands
For more information about FlowDecks Interactive mode, visit the Interactive mode docs. You can also run CLI commands directly, for documentation you can check the CLI Help or check the Commands Overview 
# Get help
flowdeck --help

​
Getting Help

Installation Guide

Get FlowDeck CLI installed on your Mac

Command Reference

Complete documentation for all CLI commands

Support

License activation and support options