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

# Uninstall

> Uninstall an app from a simulator or device

Use `uninstall` to remove an app by FlowDeck app ID or bundle ID from either a simulator or a connected device.

```bash theme={null}
# Uninstall by app ID
flowdeck uninstall <app-id>

# Uninstall by bundle ID
flowdeck uninstall com.example.MyApp

# Target a specific simulator
flowdeck uninstall com.example.MyApp --simulator "iPhone 16"

# Target a specific device
flowdeck uninstall com.example.MyApp --device "John's iPhone"

# JSON output
flowdeck uninstall <app-id> --json

# Show usage examples
flowdeck uninstall com.example.MyApp --examples
```

## Arguments

| Argument       | Description                                 |
| -------------- | ------------------------------------------- |
| `<identifier>` | App identifier (short/full ID) or bundle ID |

## Options

| Option        | Short | Description                                                           |
| ------------- | ----- | --------------------------------------------------------------------- |
| `--simulator` | `-s`  | Target simulator name or UDID (defaults to inferred/booted simulator) |
| `--device`    | `-d`  | Target connected device name or UDID                                  |
| `--json`      | `-j`  | Output as JSON                                                        |
| `--verbose`   | `-v`  | Show verbose output                                                   |
| `--examples`  | `-e`  | Show usage examples                                                   |

<Note>
  Uninstall is not available on macOS apps. Use `flowdeck stop <app-id>` for macOS launches.
</Note>
