About

xtool is a cross-platform replacement for Xcode (including build system, provisioning, deployment).

The xtool CLI supports macOS, Linux, WSL. The lower-level XKit (provisioning and device interaction) library additionally supports iOS.

Development

The majority of the code is in the Swift Package. You can use swift build / swift test / etc for iteration.
Caveat: on macOS, xtool is distributed as an app bundle (allows entitlements like Keychain). To build the Mac app, use make mac. You can then invoke the CLI at ./macOS/Build/xtool.
Make sure to run make lint (swiftlint) when you're done

Use modern Swift 6. Strict concurrency is enabled.
Use swift-dependencies (@Dependency(\.foo) / d.foo) for Dependency Injection. Passing dependencies around as arguments is an anti-pattern.
Commits should be in the format subsystem: imperative description e.g. auth: support reading password from stdin.
Don't use Task.detached { ... }. If you need to escape isolation, you want Task { @concurrent in ... } instead.
Uphold API stability guarantees for consumers who use xtool via the command line interface (e.g. don't remove subcommands or config fields). However, the Swift interface (including public types) when consuming xtool itself as a Swift Package is NOT API stable; it's okay to break Swift API.