# ipa-hub device list

List available devices.

## Usage

```shell
ipa-hub device list [options]
```

Aliases: `ls`.

## Options

| Option | Description |
| --- | --- |
| `--data-dir PATH` | Directory for downloads, app records, and server state. Defaults to `~/.ipa-hub`; the `IPA_HUB_HOME` environment variable sets an alternative default. `(string)` |
| `--json` | Print results as JSON `(boolean)` |
| `-h`, `--help` | Show help for this command `(boolean)` |
| `-v`, `--version` | Show the installed version `(boolean)` |
| `-d ID`, `--device ID` | CoreDevice ID, UDID, or exact device name `(string)` |
| `-n NAME`, `--device-name NAME` | Full, case-sensitive device name. Duplicate matches prompt for a selection. `(string)` |
| `-s`, `--include-simulators` | Include available simulators alongside physical devices `(boolean)` |
| `--only-simulators`, `--simulators-only` | Use only simulators (implies `--include-simulators`) `(boolean)` |
| `-t TYPE`, `--type TYPE`, `--device-type TYPE` | Consider only devices of these types. Repeated values include any selected type. `(string[])` May be repeated. Choices: `iphone`, `ipad`, `appletv`, `visionos`, `applewatch`. |
| `-a`, `--all` | Include destinations that are currently unavailable `(boolean)` |

## Examples

```shell
ipa-hub device list --all --device-type=iphone --device-type=ipad
```

```shell
ipa-hub device list --include-simulators
```