# CLI

Sign and install IPAs with the current user's existing Xcode signing setup.

> Requires macOS, full Xcode with a signing team, and a paired device. Missing or expired profiles are refreshed through Xcode.

## Usage

```shell
ipa-hub <command> [options]
```

## Commands

| Command | Description |
| --- | --- |
| [`ipa-hub install`](https://ipa-hub.giladgd.com/docs/cli/install.md) | Pull, sign, install, and open an IPA. |
| [`ipa-hub device`](https://ipa-hub.giladgd.com/docs/cli/device.md) | Inspect paired Apple devices and optional simulators. |
| [`ipa-hub serve`](https://ipa-hub.giladgd.com/docs/cli/serve.md) | Start the device web interface. |
| [`ipa-hub service`](https://ipa-hub.giladgd.com/docs/cli/service.md) | Manage the globally installed background service. |
| [`ipa-hub teams`](https://ipa-hub.giladgd.com/docs/cli/teams.md) | List local signing teams and unrestricted wildcard profiles, including expired profiles that Xcode can renew. |

## 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)` |

## Examples

Show flags and examples for one command.

```shell
ipa-hub --help install
```