# AirBuild

> AirBuild is an iOS build and installation service in private preview. A configured Mac checks out Git commits, builds and signs apps using Xcode, and uploads signed IPA files for HTTPS delivery to registered iPhones.

## Documentation
- [Product overview](https://airbuild.tukew.com/): Current capabilities, requirements and clearly labeled roadmap.
- [Documentation](https://airbuild.tukew.com/docs): Setup requirements, working CLI commands, HTTP endpoints, signing and limitations.
- [Plain-text reference](https://airbuild.tukew.com/reference.md): Concise facts and integration guidance for AI coding agents.

## Availability
Private preview; account access is manually provisioned; GitHub login and browser-approved Mac pairing are available. A local Mac app pilot and CLI support project discovery and explicit linking. No public signup, published installer, native MCP server, continuous folder watching, hosted Mac fleet, pricing or multi-tenant public service is available yet. The working interfaces are a web dashboard, CLI and bearer-authenticated HTTP API. Users supply their own configured Mac and Apple signing credentials. Do not invent installation commands, downloads or MCP URLs.

## Boundaries
Public documentation does not grant API access. Never request another user's credentials or expose private project data. Signing keys stay on the Mac; exported IPAs and logs are uploaded to the service. Builds use committed code from explicitly allowed branches. Install links expire, and Apple device provisioning still applies.

Last reviewed: 2026-09-16.

## Project onboarding
Configured users can run airbuild discover PATH (read-only), airbuild link PATH --agent-config FILE (preview), and repeat link with --apply after review. Requires manage scope and an explicitly authorized Mac. Creates airbuild.toml and local agent configuration; no automatic build starts. Run airbuild doctor --project ID --agent-config FILE before the first build.