# karagoz uninstall-runner

Removes every Karagöz runner app from the iPhone (com.karagozmcp.runner.\*.xctrunner, any team) and the provisioning profiles made for those ids.

- iOS device Done

## Usage

```console title="~/app"
karagoz uninstall-runner [--device <id>]
```

macOS only; a simulator or an Android device is refused with [`NOT_SUPPORTED`](https://karagozmcp.com/docs/error-codes/#not-supported). A team wildcard profile is left: other apps share it.

## Output

- `device` string: The iPhone's UDID.
- `apps` array: The bundle ids removed.
- `profiles` array: The UUIDs of the profiles removed.

Nothing to remove is not an error: both lists are empty. A running runner stops with its app. The build cache on the Mac, the certificate in your keychain and the iPhone’s registration on your developer account stay.

## Errors

[`UNINSTALL_FAILED`](https://karagozmcp.com/docs/error-codes/#uninstall-failed), [`DEVICE_NOT_READY`](https://karagozmcp.com/docs/error-codes/#device-not-ready), `NOT_SUPPORTED`, the devicectl errors and the [device selection](https://karagozmcp.com/docs/device-selection/) errors.

## MCP equivalent

MCP equivalent `uninstall_runner {}` [MCP tools](https://karagozmcp.com/docs/mcp/#tools)

Arguments: `device`. The names are the CLI's option and positional names.