Skip to main content
FlowDeck is a native Mac app for iOS and macOS development. It puts your coding agents (Claude Code, Codex, OpenCode, Cursor, or Grok Build) next to a full Apple toolchain: build, run, test, a live simulator, logs, and Git, all scoped to the session you are working in. Each session is its own Git worktree on its own branch, so several agents can work on the same project in parallel without stepping on each other.
A FlowDeck session: the agent's chat next to the app running in the simulator panel

A FlowDeck session: the agent's chat next to the app running in the simulator panel

Requirements

FlowDeck requires macOS with Xcode installed. It does not support Windows or Linux.
  • macOS 26 (Tahoe) or later
  • Apple Silicon Mac (M1 or later)
  • Xcode 26 or later, launched at least once to install components
  • Xcode Command Line Tools and an iOS simulator runtime
Support for macOS 15 (Sequoia) is temporarily suspended. We are working to restore it in an upcoming release.

Agent requirements

FlowDeck works through the coding agent CLIs you already use. Install and sign in to at least one of Claude Code, Codex, OpenCode, Cursor, or Grok Build. FlowDeck detects them during onboarding and lists them in Settings > Agents.
FlowDeck drives each agent through its own CLI and does not manage your agent credentials. If an agent doesn’t respond, make sure you can run it in your terminal first.

Getting started

The first launch walks you through five steps: verify your tools, connect agents, connect GitHub (optional), choose whether to share usage data, and open a project. See Install FlowDeck for the details.
  1. Finish onboarding, then open the sample project or your own.
  2. Pick a scheme and destination in the toolbar, then build and run.
  3. Create a session (⌘N) for each independent task, and chat with the agent in it.
See Projects & Sessions for the project and worktree workflow, or The AI Agent to start working with an agent.

Two ways to work

Use whichever fits the task. Both act on the same session.

Direct: keyboard and toolbar

Fast, precise actions you control step by step. See Keyboard Shortcuts for the full list, or press ⌘/ in the app.

Agent: natural language

Describe a goal and the agent works out the steps. Best for multi-step tasks, debugging, and anything that would take several manual actions. The conversation shows every action the agent takes, so you can follow along, answer its questions, approve permissions, or stop it at any point.

Feature tour

The AI Agent

Chat with your agent in each session, switch agents mid-conversation, attach files and screenshots, and plan work before building it.

Projects & Sessions

Keep several projects open, give each task its own worktree, and run several Chat and Plan tabs per session.

Build & Run

Build, run, and clean for the selected scheme and destination, with build errors collected in the Issues tab.

Testing

Find and run XCTest and Swift Testing tests by plan, target, suite, or test, then hand failures to the agent.

Simulators & Devices

Use a live simulator inside the window, run on devices or your Mac, and manage simulators and runtimes.

Console

Stream your running app’s logs per session, with level, keyword, and metadata filters.

Source Control

Review, commit, push, and open pull requests, comment on diffs for the agent, and let PR Autopilot fix failing checks.

Loops

Save agent tasks that run on a schedule or on demand, each in its own worktree.

Skills Manager

Install, enable, and share skills across your coding agents.

Coding Standards

Give agents FlowDeck’s guidance for Apple projects, and choose how they validate their work.

Disk Cleanup

Reclaim space from DerivedData, simulators, runtimes, and finished worktrees, safely.

UI Automation

Let the agent tap, type, scroll, and take screenshots in your running app.

Open Quickly

Reach every action, setting, session, and chat from one search field with ⌘K.

Settings

Choose default agents and models, Git and PR behavior, external tools, and appearance.

Quick Start

Install FlowDeck

Download FlowDeck and open your first project in minutes.