Skip to main content

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.

FlowDeck turns your AI agent into an iOS/macOS developer. Instead of copying terminal commands back and forth, your agent gets direct access to the full Apple development toolchain: building apps, running tests, tapping buttons on screen, reading logs, and capturing screenshots. You describe what you want in plain language. The agent does the rest. 
Run my app, navigate to the settings screen, toggle dark mode, and verify
all text is still readable. Fix any contrast issues.
That’s a real prompt. The agent will build your app, launch it on a simulator, find the settings button, tap it, toggle the switch, verify the UI, and fix any problems it finds - all without you touching Xcode or the simulator.

​
What can your agent do?

UI Automation

Your agent can see the simulator screen, tap buttons, type text, scroll, swipe, and verify results. It reads the accessibility tree to find elements and captures screenshots to confirm what happened.

Design to Code

Hand your agent a mockup image and it will implement the SwiftUI view, run the app, compare the result against the design, and iterate until it matches.

Testing

Run your full test suite or specific test classes. The agent reads failures, traces them to the source, and can fix bugs in the production code or the tests themselves.

Building and Running

Build your app, stream runtime logs, fix compiler errors, and debug runtime issues - all from natural language.

Infrastructure

Manage simulators, runtimes, devices, Swift packages, cleaning, project configuration, and licensing without memorizing any commands.

​
Watch the demo

​
How it works

FlowDeck installs a skill pack into your AI agent. The skill pack teaches the agent how to use FlowDeck commands, when to use them, and how to interpret the results. You don’t need to learn the commands yourself - the agent already knows them. The skill pack works with:
  • Claude Code (Anthropic)
  • Codex (OpenAI)
  • Gemini (Google)
  • OpenCode
  • Cursor

​
Setup

Install the skill pack in under a minute: 
flowdeck -i
Then:
  1. Press A to open AI Settings
  2. Select Install Skills
  3. Choose your agent
  4. Choose Project Only (for this repo) or Global (for all projects)
  5. Restart your AI agent
That’s it. Start prompting.
Project Only is recommended for teams - it keeps the skill pack in the repo so every contributor gets the same behavior. Global is convenient for personal use across all projects.

​
Manual install (CLI fallback)

If you prefer the command line: 
flowdeck ai install-skill --agent claude --mode project
Supported agents: claude, codex, opencode, cursor, gemini

​
Skill install paths

AgentProject InstallGlobal Install
Claude.claude/skills/flowdeck/~/.claude/skills/flowdeck/
Codex.codex/skills/flowdeck/~/.codex/skills/flowdeck/
OpenCode.opencode/skills/flowdeck/~/.config/opencode/skills/flowdeck/
Cursor.cursor/skills/flowdeck/~/.cursor/skills/flowdeck/
Gemini.gemini/skills/flowdeck/~/.gemini/skills/flowdeck/

​
Troubleshooting

​
Agent not listed in the install menu

Open the agent once so its config directory is created, then relaunch flowdeck -i and press A again.

​
Agent doesn’t use FlowDeck commands

Make sure you restarted the agent after installing the skill pack. The agent needs to reload its configuration to pick up the new skills.

​
Agent uses xcodebuild or simctl directly

The skill pack explicitly tells agents to use FlowDeck instead of raw Apple tools. If your agent still reaches for xcodebuild, try reinstalling the skill pack - an older version may be cached.