Skip to main content
Interactive mode is a persistent session that keeps your project context in memory and turns everyday tasks into single-key actions. The core loop is simple: build, run, inspect logs, run tests, and iterate without retyping flags. For scheme, target, and configuration choices, see Build Settings.

​
Core Actions

Build, Run & Test
+-------------------------------------------+
| B Build       R Run        T Test         |
| C Clean       X Stop       L Logs         |
+-------------------------------------------+

​
Build

Press B to build using the currently selected scheme, target, and configuration. Build output streams into the main content area while the status bar reflects the live state (Building, Error, Ready).

​
Run

Press R to build and launch the app on the selected target. Use Shift+R to run without rebuilding when you already have a valid build on that target.

​
Test

Press T (or U) to open test selection. You can run the entire suite, recent tests from the current session, or specific test classes/methods. Results stream live as they run.

​
Clean

Press C (or K) to open the Clean menu for project clean, Xcode cache clean, and Derived Data removal. The menu provides:
  • Clean Project – removes build artifacts for the current scheme before running a full rebuild.
  • Clean Xcode Cache – clears Xcode’s internal caches that can cache corrupted indexes.
  • Clear FlowDeck’s Derived Data – removes FlowDeck’s DerivedData directory; this may force a full rebuild for all schemes.
  • Clear Xcode Derived Data – removes Xcode’s DerivedData directory.
  • Clean All – clears scheme artifacts, FlowDeck/Xcode Derived Data, and Xcode cache in one pass.

​
Logs

Press L to open the log/test viewer:
  • Streams test output while tests are running; otherwise shows app logs while the app is running.
  • Type to filter the buffer and use Backspace to edit the filter.
  • Scroll with ↑/↓, Page Up/Page Down, Home, and End; auto-scroll resumes when you reach the bottom.
  • Press Esc to exit back to the main view.

​
Stop and Cancel

Press X to stop a running app. Use ESC during a build or test to cancel the current operation. See Project Tools and Manage Devices and Simulators for helper menus, persistence, and session tools.