Skip to main content
FlowDeck CLI includes a powerful interactive mode that provides a terminal-based IDE experience. Launch it with flowdeck -i to get a persistent development environment with keyboard shortcuts, log streaming, and a status bar. You can open an existing project or create a new one directly from interactive mode.

​
Launching Interactive Mode

cd ~/Projects/MyApp
flowdeck -i
On first run, the interactive mode will guide you through a setup assistant to configure your workspace, scheme, and target. The setup assistant walks you through selecting or creating a project, then choosing a workspace, scheme, and target so you can start building immediately.

​
Project Workflows

  • Create a Project – Pick a template, name the app, and let FlowDeck scaffold the .xcodeproj before continuing with configuration. See Working with Projects for the full prompts.
  • Open a Project – Choose an existing .xcworkspace or .xcodeproj, select among multiple workspaces if needed, and then pick schemes and targets. See Working with Projects for details.

​
Example Session

Clean Shot2025 12 17at18 39 48@2x

​
Status Bar

The bottom of the terminal displays a persistent status bar showing:
  • Project name and git branch
  • Current scheme
  • Target (simulator or device)
  • Build configuration (Debug/Release)
  • App status (Idle, Building, Running, Error)

​
Build, Run & Test

Start with the core commands, then dig into build settings, tools, shortcuts, and support.

Working with Projects

Create a new project or open an existing one during setup.

Build, Run & Test

Core commands for build, run, test, logs, and stop.

Build Settings

Scheme, target, configuration, and workspace selection.

Project Tools

Manage packages, sync profiles, export configs, and open in Xcode.

Command Reference

Build, run, test, build settings, and navigation keys.

Troubleshooting

Built-in help, CLI options, and common issues.