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

# FlowDeck for Mac

> A native macOS IDE for Apple development, with a built-in AI agent

FlowDeck is a native Mac app for iOS and macOS development. You get a complete IDE — build, run, test, debug, manage simulators and devices, stream logs, and review source control — plus an AI agent that can drive all of it from a conversation.

## Requirements

<Warning>
  FlowDeck requires macOS with Xcode installed. It does not support Windows or Linux.
</Warning>

* **macOS** 26 (Tahoe) or later
* **Apple Silicon Mac** (M1 or later) recommended
* **Xcode** 26 or later, launched at least once to install components

<Note>
  Support for macOS 15 (Sequoia) is temporarily suspended. We are working to
  restore it in an upcoming release.
</Note>

### AI Agent requirements

The built-in agent works through your existing AI CLI installation. You need at least one of
**Claude Code**, **Codex**, **OpenCode**, **Cursor**, or **Grok Build** installed and
authenticated. See [Supported agents](/macos/ai-agent#supported-agents) for the full list, the
command each one uses, and how to sign in.

<Note>
  FlowDeck drives the agent through your installed CLI — it does not manage credentials itself. If the agent doesn't respond, make sure you can run it successfully in your terminal first.
</Note>

## Two ways to work

FlowDeck gives you two interaction modes that complement each other. Use whichever fits the task.

### Direct — keyboard shortcuts and UI

Fast, precise actions you control step by step. Best when you know exactly what you want to do.

| Action                 | Shortcut |
| ---------------------- | -------- |
| Open Quickly           | **⌘K**   |
| Build                  | **⌘B**   |
| Build and Run          | **⌘R**   |
| Run Without Building   | **⌃⌘R**  |
| Test                   | **⌘U**   |
| Clean                  | **⇧⌘K**  |
| Add Project            | **⌘O**   |
| New Session            | **⌘N**   |
| Show or Hide Simulator | **⇧⌘0**  |
| Show or Hide Inspector | **⌥⌘0**  |
| Show or Hide Console   | **⇧⌘Y**  |
| Keyboard Shortcuts     | **⌘/**   |

Press **⌘/** for the full list in the app, or see [Keyboard
Shortcuts](/macos/keyboard-shortcuts). You can also drive everything from the toolbar and sidebar
panels without remembering any of them — and **⌘K** finds any action by name.

### Agent — natural language

Describe a goal and the agent figures out the steps. Best for multi-step tasks, debugging, and anything that would take several manual actions to accomplish.

| Instead of...                                              | Say to the agent...                                                                             |
| ---------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| Build → read errors → open file → fix → rebuild            | "Build the app and fix any compiler errors you find."                                           |
| Run tests → read failures → trace to source → edit → rerun | "Run the LoginTests suite. If anything fails, fix it."                                          |
| Launch → navigate manually → screenshot → compare          | "Open the app, go to the profile screen, and take a screenshot."                                |
| Write test boilerplate manually                            | "Write unit tests for the PaymentProcessor class."                                              |
| Read logs while tapping through the app                    | "Run the app, go through the onboarding flow, and tell me if there are any errors in the logs." |
| Review Changes tab → write commit message → stage → commit | "Summarize what I've changed and suggest a commit message."                                     |

The agent shows every action it takes in the conversation so you can follow along, intervene, or redirect at any point.

## Feature overview

<CardGroup cols={2}>
  <Card title="AI Agent" icon="robot" href="/macos/ai-agent">
    The built-in agent builds, tests, debugs, and automates — driven by a conversation.
  </Card>

  <Card title="Build & Run" icon="hammer" href="/macos/building">
    Compile and launch apps on simulators, devices, or your Mac.
  </Card>

  <Card title="Testing" icon="flask-vial" href="/macos/testing">
    Run unit and UI tests, see results inline, let the agent fix failures.
  </Card>

  <Card title="Simulators & Devices" icon="mobile-screen-button" href="/macos/simulators">
    Boot simulators, deploy to physical devices, manage runtimes.
  </Card>

  <Card title="Console" icon="terminal" href="/macos/logging">
    Real-time OSLog streaming from running apps, with level and keyword filtering.
  </Card>

  <Card title="UI Automation" icon="hand-pointer" href="/macos/ui-automation">
    Tap, type, scroll, and screenshot — driven by the agent.
  </Card>

  <Card title="Source Control" icon="code-branch" href="/macos/source-control">
    Review diffs, stage, commit, push, open pull requests, and let FlowDeck monitor them.
  </Card>

  <Card title="Open Quickly" icon="magnifying-glass" href="/macos/command-palette">
    ⌘K finds any project, session, or action by name.
  </Card>

  <Card title="Skills Manager" icon="puzzle-piece" href="/macos/skills-manager">
    Install and remove the skills your agent CLIs read.
  </Card>

  <Card title="Disk Cleanup" icon="broom" href="/macos/disk-cleanup">
    Find where Apple development put your disk space and reclaim it safely.
  </Card>
</CardGroup>

## Quick Start

<Card title="Install FlowDeck" icon="download" href="/macos/install">
  Download FlowDeck and open your first project in minutes.
</Card>