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

# Give Your Agent Eyes and Hands

> Your AI agent can see the simulator screen, tap buttons, run tests, and build your iOS and macOS apps

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.

```text theme={null}
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?

<CardGroup cols={2}>
  <Card title="UI Automation" icon="hand-pointer" href="/cli/ai-agents/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.
  </Card>

  <Card title="Design to Code" icon="paintbrush" href="/cli/ai-agents/ui-implementation">
    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.
  </Card>

  <Card title="Testing" icon="flask-vial" href="/cli/ai-agents/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.
  </Card>

  <Card title="Building and Running" icon="hammer" href="/cli/ai-agents/building">
    Build your app, stream runtime logs, fix compiler errors, and debug runtime issues - all from natural language.
  </Card>

  <Card title="Infrastructure" icon="server" href="/cli/ai-agents/infrastructure">
    Manage simulators, runtimes, devices, Swift packages, cleaning, project configuration, and licensing without memorizing any commands.
  </Card>
</CardGroup>

## Watch the demo

<iframe src="https://www.youtube.com/embed/1ANlOys4bTI" title="YouTube video player" frameborder="0" className="w-full aspect-video rounded-xl" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen />

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

```bash theme={null}
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.

<Tip>
  **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.
</Tip>

### Manual install (CLI fallback)

If you prefer the command line:

```bash theme={null}
flowdeck ai install-skill --agent claude --mode project
```

Supported agents: `claude`, `codex`, `opencode`, `cursor`, `gemini`

### Skill install paths

| Agent    | Project Install              | Global 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.