# ipa-hub

> Install and manage IPA apps on paired Apple devices using your Mac’s Xcode signing setup.

Version: 0.1.0. Requires macOS, Node.js 24+ or Bun 1.4.2+.

[Complete documentation](https://ipa-hub.giladgd.com/llms-full.txt)

## Guide

### Discover

- [Awesome List](https://ipa-hub.giladgd.com/docs/guide/awesome-list.md): Explore curated unsigned apps for iPhone, iPad, Apple TV, Vision Pro, and Apple Watch, with ready-to-copy install commands.

### Basics

- [Getting started](https://ipa-hub.giladgd.com/docs/guide/getting-started.md): ipa-hub downloads, signs, and installs IPA apps on your paired Apple devices. Run a single command on your Mac, or keep a server running and manage your apps from the manager.

- [Installing apps](https://ipa-hub.giladgd.com/docs/guide/sources.md): Use a release, a direct IPA URL, or a file on your Mac. The source is saved with the installed app so ipa-hub knows where to check for updates.

- [Devices and signing](https://ipa-hub.giladgd.com/docs/guide/devices.md): ipa-hub uses paired Apple devices reported by Xcode. Physical devices are included by default; simulators are optional.

- [Environment variables](https://ipa-hub.giladgd.com/docs/guide/environment-variables.md): Configure ipa-hub through the environment of the process doing the work: your CLI command, foreground server, or application using the library. Explicit command options take precedence over their environment defaults.

### Your network

- [Server and App Manager](https://ipa-hub.giladgd.com/docs/guide/server.md): App Manager gives your devices a shared home for app installation, updates, and signature refreshes. Signing and installation happen on your Mac.

### For developers

- [Remote coding agents](https://ipa-hub.giladgd.com/docs/guide/remote-agents.md): Let a coding agent on another machine build and update one app on your phone, while your Mac keeps its signing certificates and paired-device access. You approve the first installation, then give the agent a private global update URL for that app on that device.

- [In-app updates](https://ipa-hub.giladgd.com/docs/guide/app-updates.md): This is the integration contract for apps installed through ipa-hub. The manager is hosted at <https://ipa-hub.giladgd.com/app/ ; the app-update endpoints described here continue to run on the user's Mac. Do not send update requests to GitHub Pages.

- [Swift client](https://ipa-hub.giladgd.com/docs/guide/swift-client.md): A Foundation client for optional in-app updates.

### Contributing

- [Setting Up a Dev Environment](https://ipa-hub.giladgd.com/docs/guide/development.md): Set up a checkout to work on ipa-hub's CLI, library, App Manager, or website. Follow the steps below, then read the pull request guidelines before submitting your changes.

- [Pull Request Guidelines](https://ipa-hub.giladgd.com/docs/guide/contributing.md): Keep each pull request focused on a clear improvement to ipa-hub. Explain the problem, the resulting behavior, and how you verified it so reviewers can assess the change.

- [Contribute an app](https://ipa-hub.giladgd.com/docs/guide/contributing-apps.md): The Awesome List is a curated collection of apps with downloadable IPA releases. Suggest an app by opening a pull request with an entry, its icon source URL, and attribution. You do not need to add image files or edit the website's React components or generated documentation.

## CLI

### Commands

- [CLI](https://ipa-hub.giladgd.com/docs/cli.md): Sign and install IPAs with the current user's existing Xcode signing setup.

- [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 device list](https://ipa-hub.giladgd.com/docs/cli/device/list.md): List available devices.

  - [ipa-hub device info](https://ipa-hub.giladgd.com/docs/cli/device/info.md): Show a device summary, installed applications, and apps tracked by ipa-hub.

- [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 service install](https://ipa-hub.giladgd.com/docs/cli/service/install.md): Install and start a LaunchAgent that also starts at user login (global installs only).

  - [ipa-hub service manager](https://ipa-hub.giladgd.com/docs/cli/service/manager.md): Install App Manager (ipa-hub on the Home Screen) on an iPhone or iPad.

    - [ipa-hub service manager install](https://ipa-hub.giladgd.com/docs/cli/service/manager/install.md): Set up App Manager from Safari and wait for its Home Screen app to connect.

  - [ipa-hub service uninstall](https://ipa-hub.giladgd.com/docs/cli/service/uninstall.md): Remove the service, retaining app records and downloads.

  - [ipa-hub service start](https://ipa-hub.giladgd.com/docs/cli/service/start.md): Start the installed service.

  - [ipa-hub service stop](https://ipa-hub.giladgd.com/docs/cli/service/stop.md): Stop the service until the next login or explicit start.

  - [ipa-hub service status](https://ipa-hub.giladgd.com/docs/cli/service/status.md): Show whether the service is installed and running.

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

## API Reference

### Functions

- [Function: getIpaHub()](https://ipa-hub.giladgd.com/docs/api/functions/getIpaHub.md): Initialize an ipa-hub instance for library use. ipa-hub TypeScript API reference.

### Classes

- [Class: IpaHub](https://ipa-hub.giladgd.com/docs/api/classes/IpaHub.md): Manage IPA sources, paired devices, installations, and updates. Create an instance with getIpaHub. ipa-hub TypeScript API reference.

- [Class: SelectionRequired](https://ipa-hub.giladgd.com/docs/api/classes/SelectionRequired.md): TypeScript reference for SelectionRequired in ipa-hub. Install and manage IPA apps on paired Apple devices using Node.js or Bun.

### Types

- [Type Alias: AppUpdateResult](https://ipa-hub.giladgd.com/docs/api/type-aliases/AppUpdateResult.md): TypeScript reference for AppUpdateResult in ipa-hub. Install and manage IPA apps on paired Apple devices using Node.js or Bun.

- [Type Alias: Asset](https://ipa-hub.giladgd.com/docs/api/type-aliases/Asset.md): One published IPA. A missing size means the publisher did not provide one. ipa-hub TypeScript API reference.

- [Type Alias: CheckUpdateOptions](https://ipa-hub.giladgd.com/docs/api/type-aliases/CheckUpdateOptions.md): TypeScript reference for CheckUpdateOptions in ipa-hub. Install and manage IPA apps on paired Apple devices using Node.js or Bun.

- [Type Alias: Choice](https://ipa-hub.giladgd.com/docs/api/type-aliases/Choice.md): TypeScript reference for Choice in ipa-hub. Install and manage IPA apps on paired Apple devices using Node.js or Bun.

- [Type Alias: Device](https://ipa-hub.giladgd.com/docs/api/type-aliases/Device.md): TypeScript reference for Device in ipa-hub. Install and manage IPA apps on paired Apple devices using Node.js or Bun.

- [Type Alias: DeviceFilter](https://ipa-hub.giladgd.com/docs/api/type-aliases/DeviceFilter.md): TypeScript reference for DeviceFilter in ipa-hub. Install and manage IPA apps on paired Apple devices using Node.js or Bun.

- [Type Alias: DeviceInfo](https://ipa-hub.giladgd.com/docs/api/type-aliases/DeviceInfo.md): TypeScript reference for DeviceInfo in ipa-hub. Install and manage IPA apps on paired Apple devices using Node.js or Bun.

- [Type Alias: DeviceType](https://ipa-hub.giladgd.com/docs/api/type-aliases/DeviceType.md): TypeScript reference for DeviceType in ipa-hub. Install and manage IPA apps on paired Apple devices using Node.js or Bun.

- [Type Alias: Identity](https://ipa-hub.giladgd.com/docs/api/type-aliases/Identity.md): TypeScript reference for Identity in ipa-hub. Install and manage IPA apps on paired Apple devices using Node.js or Bun.

- [Type Alias: InstalledApp](https://ipa-hub.giladgd.com/docs/api/type-aliases/InstalledApp.md): Information about an app tracked by ipa-hub. Storage and authentication details are kept internal. ipa-hub TypeScript API reference.

- [Type Alias: InstallOptions](https://ipa-hub.giladgd.com/docs/api/type-aliases/InstallOptions.md): Download, sign, and install an IPA on a paired device. ipa-hub TypeScript API reference.

- [Type Alias: InstallResult](https://ipa-hub.giladgd.com/docs/api/type-aliases/InstallResult.md): TypeScript reference for InstallResult in ipa-hub. Install and manage IPA apps on paired Apple devices using Node.js or Bun.

- [Type Alias: Interaction](https://ipa-hub.giladgd.com/docs/api/type-aliases/Interaction.md): TypeScript reference for Interaction in ipa-hub. Install and manage IPA apps on paired Apple devices using Node.js or Bun.

- [Type Alias: IpaHubOptions](https://ipa-hub.giladgd.com/docs/api/type-aliases/IpaHubOptions.md): Configuration shared by operations on an IpaHub instance. ipa-hub TypeScript API reference.

- [Type Alias: ListReleasesOptions](https://ipa-hub.giladgd.com/docs/api/type-aliases/ListReleasesOptions.md): Page numbers come from the previous result's nextPage; credentials are used for this request only. ipa-hub TypeScript API reference.

- [Type Alias: LocalSource](https://ipa-hub.giladgd.com/docs/api/type-aliases/LocalSource.md): TypeScript reference for LocalSource in ipa-hub. Install and manage IPA apps on paired Apple devices using Node.js or Bun.

- [Type Alias: ManagerInstallOptions](https://ipa-hub.giladgd.com/docs/api/type-aliases/ManagerInstallOptions.md): TypeScript reference for ManagerInstallOptions in ipa-hub. Install and manage IPA apps on paired Apple devices using Node.js or Bun.

- [Type Alias: ManagerInstallResult](https://ipa-hub.giladgd.com/docs/api/type-aliases/ManagerInstallResult.md): TypeScript reference for ManagerInstallResult in ipa-hub. Install and manage IPA apps on paired Apple devices using Node.js or Bun.

- [Type Alias: Platform](https://ipa-hub.giladgd.com/docs/api/type-aliases/Platform.md): TypeScript reference for Platform in ipa-hub. Install and manage IPA apps on paired Apple devices using Node.js or Bun.

- [Type Alias: Profile](https://ipa-hub.giladgd.com/docs/api/type-aliases/Profile.md): TypeScript reference for Profile in ipa-hub. Install and manage IPA apps on paired Apple devices using Node.js or Bun.

- [Type Alias: Progress](https://ipa-hub.giladgd.com/docs/api/type-aliases/Progress.md): A missing total means the operation has no reliable percentage. ipa-hub TypeScript API reference.

- [Type Alias: Provider](https://ipa-hub.giladgd.com/docs/api/type-aliases/Provider.md): TypeScript reference for Provider in ipa-hub. Install and manage IPA apps on paired Apple devices using Node.js or Bun.

- [Type Alias: PullOptions](https://ipa-hub.giladgd.com/docs/api/type-aliases/PullOptions.md): Download an IPA without signing or installing it. ipa-hub TypeScript API reference.

- [Type Alias: PullResult](https://ipa-hub.giladgd.com/docs/api/type-aliases/PullResult.md): TypeScript reference for PullResult in ipa-hub. Install and manage IPA apps on paired Apple devices using Node.js or Bun.

- [Type Alias: ReleaseInfo](https://ipa-hub.giladgd.com/docs/api/type-aliases/ReleaseInfo.md): TypeScript reference for ReleaseInfo in ipa-hub. Install and manage IPA apps on paired Apple devices using Node.js or Bun.

- [Type Alias: ReleasePage](https://ipa-hub.giladgd.com/docs/api/type-aliases/ReleasePage.md): TypeScript reference for ReleasePage in ipa-hub. Install and manage IPA apps on paired Apple devices using Node.js or Bun.

- [Type Alias: ReleaseSource](https://ipa-hub.giladgd.com/docs/api/type-aliases/ReleaseSource.md): TypeScript reference for ReleaseSource in ipa-hub. Install and manage IPA apps on paired Apple devices using Node.js or Bun.

- [Type Alias: ResolvedSource](https://ipa-hub.giladgd.com/docs/api/type-aliases/ResolvedSource.md): TypeScript reference for ResolvedSource in ipa-hub. Install and manage IPA apps on paired Apple devices using Node.js or Bun.

- [Type Alias: ResolveOptions](https://ipa-hub.giladgd.com/docs/api/type-aliases/ResolveOptions.md): Source browsing options. Credentials are used for this operation only. ipa-hub TypeScript API reference.

- [Type Alias: Selection](https://ipa-hub.giladgd.com/docs/api/type-aliases/Selection.md): TypeScript reference for Selection in ipa-hub. Install and manage IPA apps on paired Apple devices using Node.js or Bun.

- [Type Alias: Source](https://ipa-hub.giladgd.com/docs/api/type-aliases/Source.md): A local file, a direct download, or a repository release. ipa-hub TypeScript API reference.

- [Type Alias: SourceAuthentication](https://ipa-hub.giladgd.com/docs/api/type-aliases/SourceAuthentication.md): TypeScript reference for SourceAuthentication in ipa-hub. Install and manage IPA apps on paired Apple devices using Node.js or Bun.

- [Type Alias: Team](https://ipa-hub.giladgd.com/docs/api/type-aliases/Team.md): TypeScript reference for Team in ipa-hub. Install and manage IPA apps on paired Apple devices using Node.js or Bun.

- [Type Alias: UpdateAllAppsOptions](https://ipa-hub.giladgd.com/docs/api/type-aliases/UpdateAllAppsOptions.md): TypeScript reference for UpdateAllAppsOptions in ipa-hub. Install and manage IPA apps on paired Apple devices using Node.js or Bun.

- [Type Alias: UpdateAppOptions](https://ipa-hub.giladgd.com/docs/api/type-aliases/UpdateAppOptions.md): TypeScript reference for UpdateAppOptions in ipa-hub. Install and manage IPA apps on paired Apple devices using Node.js or Bun.

- [Type Alias: UpdateCheck](https://ipa-hub.giladgd.com/docs/api/type-aliases/UpdateCheck.md): TypeScript reference for UpdateCheck in ipa-hub. Install and manage IPA apps on paired Apple devices using Node.js or Bun.

- [Type Alias: UrlSource](https://ipa-hub.giladgd.com/docs/api/type-aliases/UrlSource.md): TypeScript reference for UrlSource in ipa-hub. Install and manage IPA apps on paired Apple devices using Node.js or Bun.

### Variables

- [Variable: DEVICE TYPES](https://ipa-hub.giladgd.com/docs/api/variables/DEVICE_TYPES.md): TypeScript reference for DEVICE_TYPES in ipa-hub. Install and manage IPA apps on paired Apple devices using Node.js or Bun.