> ## Documentation Index
> Fetch the complete documentation index at: https://flowdeck.studio/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> A terminal-based IDE experience for iOS/macOS development

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

```bash theme={null}
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](/cli/interactive/working-with-projects#creating-a-project) 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](/cli/interactive/working-with-projects#opening-a-project) for details.

## Example Session

<img src="https://mintcdn.com/flowdeck/1ORqBD4UYIgP5hgK/images/CleanShot2025-12-17at18.39.48@2x.png?fit=max&auto=format&n=1ORqBD4UYIgP5hgK&q=85&s=59c9b367769392675d768b78d8e15e03" alt="Clean Shot2025 12 17at18 39 48@2x" width="1824" height="1488" data-path="images/CleanShot2025-12-17at18.39.48@2x.png" />

## 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.

<CardGroup cols={2}>
  <Card title="Working with Projects" icon="folder" href="/cli/interactive/working-with-projects">
    Create a new project or open an existing one during setup.
  </Card>

  <Card title="Build, Run & Test" icon="sparkles" href="/cli/interactive/build-run-test">
    Core commands for build, run, test, logs, stop, and uninstall.
  </Card>

  <Card title="Build Settings" icon="sliders" href="/cli/interactive/build-settings">
    Scheme, target, configuration, and workspace selection.
  </Card>

  <Card title="Project Tools" icon="gear" href="/cli/interactive/tools-settings/project-commands">
    Manage packages, sync profiles, export configs, and open in Xcode.
  </Card>

  <Card title="Command Reference" icon="keyboard" href="/cli/interactive/shortcuts">
    Build, run, test, build settings, and navigation keys.
  </Card>

  <Card title="Troubleshooting" icon="life-ring" href="/cli/interactive/help">
    Built-in help, CLI options, and common issues.
  </Card>
</CardGroup>