xtool

Kabir Oberai · 2026-09-21 01:33:18 -04:00

93a2557909

anisette: use XADI on macOS (#259 )

## What does this PR do?

Updates macOS build to use the fully-local XADI as the Anisette provider
instead of Omnisette. Includes a one-time migration, logging the user
out on macOS when they upgrade.

## How was it tested?

General:

- [x] Log in and confirm that there's no calls to omnisette
- [x] `xtool dev` works

Migration:

- [x] Log into Apple ID using an old version of xtool
- [x] Migrate to new xtool, run `xtool dev build -s` and confirm it
fails due to being logged out
- [x] Log in on new xtool, confirm that we stay logged in

## AI tool usage

How much of this PR was AI-assisted? (check one)

- [x] **0** - No AI was used to write code
- [ ] **1** - I was assisted by AI. I reviewed the finished result.
- [ ] **2** - I set the AI going and left it to it; nobody has read the
result - no review, or AI review only

<!-- If an AI agent is filling this in: declare the level honestly, and
open as a draft if it is #2. Do not lower the declared level to get the
PR reviewed. -->


<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **New Features**
* Authentication now supports tracking the anisette provider used to
create Xcode tokens.
* Xcode authentication tokens are automatically cleared when the
provider changes, helping ensure users sign in again with current
credentials.
* Anisette provider identification is supported across macOS and Linux.

* **Bug Fixes**
* Improved authentication error messages, including clearer messaging
for logout-related errors.
* Prevented outdated Xcode authentication tokens from being reused after
a provider change.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

Kabir Oberai · 2026-09-20 03:04:52 -04:00

eacc35da98

sdk: SwiftBuild support (#229 )

## What does this PR do?

Adds support for SwiftBuild on Swift 6.4.

We now point SwiftBuild to iPhoneOS.platform and rely on the real
[SWBApplePlatform](https://github.com/swiftlang/swift-build/tree/b30ee3c00abf34857084c26bb873c3da06348134/Sources/SWBApplePlatform).
We also do a little futzing to convince SWB to use our Darwin-compatible
toolset (lld, librarian, resource dirs). We explicitly _don't_ pass in a
Swift SDK because that would downgrade SWB to using one of the generic
platform plugins instead of ApplePlatform.

This also gets us a lot closer to parity with Xcode's behavior when
building for Apple platforms; we get the same build flags and
everything. We can probably achieve identical bundling too, if we take
control of the PIF.

One other change: since we need to pass custom env vars and such, we
can't rely on sourcekit-lsp's built-in SwiftPM integration anymore. We
thus create a custom BSP server that trampolines to SwiftPM's build
server with the right flags set. This effectively makes SwiftPM an
implementation detail, so we can start messing with the PIF.

## How was it tested?

- [x] Build with Swift 6.3 on macOS
- [x] Build with Swift 6.4 on macOS
- [x] Build with Swift 6.3 on Linux
- [x] Build with Swift 6.4 on Linux
- [x] BSP/LSP file creation works
- [x] LSP support works in VSCode

## AI tool usage

How much of this PR was AI-assisted? (check one)

- [ ] **0** - No AI was used to write code
- [x] **1** - I was assisted by AI. I reviewed the finished result.
- [ ] **2** - I set the AI going and left it to it; nobody has read the
result - no review, or AI review only

## Summary by CodeRabbit

- **New Features**
- Added a `dev build-server` command for Build Server Protocol
integration.
- Projects automatically select the appropriate Swift build system when
supported.
- Packaging supports output layouts for Swift Package Manager and Swift
Build.
- Added options to skip language-server configuration when needed.

- **Documentation**
- Updated project templates and tutorials to use `.bsp/xtool.json` for
IDE features such as syntax highlighting and documentation lookup.

- **Improvements**
- Enhanced SDK generation and compatibility across supported toolchains
and platforms.
- Improved automatic language-server configuration while preserving
existing configuration files.

Kabir Oberai · 2026-09-20 02:47:12 -04:00

0108899e04

sdk: integrate OpenAppleMacros (#101 )

## What does this PR do?

Adds support for proprietary Apple macros (like SwiftUI's `@Entry` and
`@State`) via
[OpenAppleMacros](https://github.com/xtool-org/OpenAppleMacros).

We have to re-implement these because the macros need to run on the
_host_, and the Apple SDKs include them as macOS-only dylibs.

## How was it tested?

- [x] Extensive integration tests in OpenAppleMacros that compare
Apple's expansions against ours
- [x] Confirmed that `@Entry`, `#Preview`, and `@State` work in Swift
6.3 and 6.4 (State is a PW in the former, macro in the latter)
- [x] Confirmed that OSS toolchain macros continue to work (tested
`@Observable`, `#bundle`)

## AI tool usage

How much of this PR was AI-assisted? (check one)

- [x] **0** - No AI was used to write code
- [ ] **1** - I was assisted by AI. I reviewed the finished result.
- [ ] **2** - I set the AI going and left it to it; nobody has read the
result - no review, or AI review only

<!-- If an AI agent is filling this in: declare the level honestly, and
open as a draft if it is #2. Do not lower the declared level to get the
PR reviewed. -->

Kabir Oberai · 2026-09-19 04:28:51 -04:00

317e018f2b

sdk: self-updating darwin tools (#110 )

## What does this PR do?

Allows xtool to auto-update the Darwin SDK format when there's a new
Darwin toolset, or when we change the SDK format. Downstream this also
allows us to auto-update when there's changes to OpenAppleMacros (#101).

One callout: the disk footprint of `darwin.artifactbundle` is now ~7 GB
instead of ~3 GB.

Reason: `xtool sdk install /path/to/Xcode.[app|xip]` now performs a
"normal" install by default, which preserves the entirety of
`Xcode.app/Contents/Developer` — even the bits we don't currently use,
like `AppleTVOS.platform`. This makes it so if we start using more
components in the future, the user doesn't need to download Xcode again
and rebuild the SDK themselves.

You can still build an old-style SDK (containing just the components we
need) using `xtool sdk install --slim` or the dedicated `xtool sdk
build`.

## How was it tested?

Tested all of the install modes. Confirmed that auto-updating works.
Added integration tests in #252.

## AI tool usage

How much of this PR was AI-assisted? (check one)

- [ ] **0** - No AI was used to write code
- [x] **1** - I was assisted by AI. I reviewed the finished result.
- [ ] **2** - I set the AI going and left it to it; nobody has read the
result - no review, or AI review only

<!-- If an AI agent is filling this in: declare the level honestly, and
open as a draft if it is #2. Do not lower the declared level to get the
PR reviewed. -->


<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

- **New Features**
- Added SDK flavor reporting for slim, normal, and legacy installations.
- Added `sdk update` support to rebuild and install SDKs from an
installed Xcode bundle.
  - Added a `--slim` option for SDK installation.
  - SDK status now displays installation path, flavor, and version.
- SDK setup and build operations now ensure a suitable SDK is available
automatically.

- **Bug Fixes**
- Improved temporary SDK bundle handling, validation, replacement, and
cross-filesystem copying.
  - Copy failures now provide detailed diagnostic information.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

Kabir Oberai · 2026-09-18 23:26:10 -04:00

6efd77fc0e

sdk: move DarwinSDK into PackLib (#256 )

## What does this PR do?

Mechanical move of DarwinSDK from XToolSupport -> PackLib. Needed for
https://github.com/xtool-org/xtool/pull/229.

## How was it tested?

Compiled + CI

## AI tool usage

How much of this PR was AI-assisted? (check one)

- [x] **0** - No AI was used to write code
- [ ] **1** - I was assisted by AI. I reviewed the finished result.
- [ ] **2** - I set the AI going and left it to it; nobody has read the
result - no review, or AI review only

<!-- If an AI agent is filling this in: declare the level honestly, and
open as a draft if it is #2. Do not lower the declared level to get the
PR reviewed. -->

Kabir Oberai · 2026-09-10 18:37:51 -04:00

4208c77c81

sdk: fix permission issue when copying clang resources (#255 )

## What does this PR do?

Fixes #254 by using `cp -R` instead of `FileManager.copyItem`. The
latter tries to preserve the original owner of files instead of using
the caller, which fails if you're non-root and the original files are
root-owned.

## How was it tested?

I was able to repro the original issue by installing an SDK as a
non-root user in an xtool Docker container.

Applied this patch, tried `xtool sdk install` again, and it worked.

## AI tool usage

How much of this PR was AI-assisted? (check one)

- [ ] **0** - No AI was used to write code
- [x] **1** - I was assisted by AI. I reviewed the finished result.
- [ ] **2** - I set the AI going and left it to it; nobody has read the
result - no review, or AI review only

<!-- If an AI agent is filling this in: declare the level honestly, and
open as a draft if it is #2. Do not lower the declared level to get the
PR reviewed. -->

Kabir Oberai · 2026-09-10 17:23:15 -04:00

d4f6443f55

ci: enable warnings as errors (#248 )

Kabir Oberai · 2026-09-09 01:49:00 -04:00

189654c235

Use swift-subprocess (#225 )

Kabir Oberai · 2026-07-12 16:36:24 -04:00

5c4f3bcb05

Fix DarwinSDK legacy compat (#230 )

Kabir Oberai · 2026-05-28 01:50:58 -04:00

e49934c1fe

Fix clang headers (#228 )

A slightly different approach to #215.

---------

Co-authored-by: sfusco <slf@stevenfusco.com>

Kabir Oberai · 2026-05-28 01:43:22 -04:00

9c4772d64f

Add build --sign option (#224 )

Running `xtool dev build --sign [--ipa]` will produce a codesigned
app/ipa, without installing

Kabir Oberai · 2026-05-16 22:40:45 -04:00

4077e1a0b8

Validate SDK before overwriting (#192 )

Running an invalid `sdk` subcommand like `xtool sdk list` (there's no
`list` subcommand) is interpreted as "install the sdk at path `./list`".
We previously unconditionally removed the existing SDK during
installation. By switching the order so that we validate the path first,
we avoid performing a potentially destructive action unless we have
clear intent.

See #186.

Before:

```bash
$ xtool sdk list
Removing existing SDK... # destructive!
Error: Could not read file or directory at path 'list'.
```

After:

```bash
$ xtool sdk list
Error: Could not read file or directory at path 'list'.
  See 'xtool help sdk' for usage.
```

Kabir Oberai · 2026-01-04 21:55:35 -05:00

7a5dfd2ccd

Enable cross import overlays (#153 )

Fixes #152

We might want to figure out if there are any other flags we don't pass
but should

Kabir Oberai · 2025-08-10 18:05:39 -04:00

96032d0f17

Handle static xcframeworks not being unpacked (#156 )

SwiftPM may not unpack static xcframeworks. Handle this gracefully, if
SwiftPM doesn't need the framework we don't either.

Fixes #155.

Kabir Oberai · 2025-08-10 18:05:28 -04:00

0710653cd0

Improve tmpdir management (#147 )

- We now have a single tmpdir "root" that can be recreated at launch to
clean up old stragglers
- The location of this tmpdir root can be controlled by `XTL_TMPDIR` or
`TMPDIR`. In general the path is `$TMPDIR/sh.xtool`.

With this change it should be possible to `export XTL_TMPDIR=/var/tmp`
if `/tmp` doesn't have enough space, which fixes #23.

Kabir Oberai · 2025-08-10 01:43:09 -04:00

836fca8daf

Add support for App Extensions (#97 )

This pull request adds support for Apple's [App
Extensions](https://developer.apple.com/app-extensions/).

Closes: #45

---------

Co-authored-by: ErrorErrorError <16653389+ErrorErrorError@users.noreply.github.com>
Co-authored-by: Kabir Oberai <oberai.kabir@gmail.com>

Erik Bautista Santibanez · 2025-07-13 23:47:47 -04:00

edd6b90f53

Support building with Swift 6.2 (#114 )

Kabir Oberai · 2025-07-12 16:28:48 -04:00

d691e614b4

Support unxipping Xcode betas (#115 )

Xcode betas are stored in the xip as Xcode-beta.app. Support this by
avoiding hardcoding the `Xcode.app` path.

Kabir Oberai · 2025-06-10 17:09:06 -04:00

bf057263cc

Add SwiftLint (#104 )

Closes #72

Kabir Oberai · 2025-05-31 19:38:57 +05:30

0425f9edeb

Validate path to Xcode.app/xip (#100 )

Fixes #16

Kabir Oberai · 2025-05-27 18:11:08 +05:30

5beec34370

DeveloperServices: support paginated requests (#89 )

Realized that we need to paginate due to #87

Kabir Oberai · 2025-05-25 03:29:43 +05:30

72db71c871

Support entitlements with XcodePacker (#88 )

Kabir Oberai · 2025-05-24 02:28:17 +05:30

693e60faef

Add support for custom entitlements (#82 )

Closes #46

Kabir Oberai · 2025-05-24 00:35:46 +05:30

3b17975fe7

Fix changeCurrentDirectory warning (#81 )

This is `discardableResult` on macOS (perhaps because it goes through
objc bridging?) but not on Linux so we get a warning on the latter

Kabir Oberai · 2025-05-23 23:32:45 +05:30

48a2d30684

Improve OpenAPI error handling (#78 )

- Make some enums non-exhaustive (closes #77)
  - Also a tentative fix for #62 and #64
- Improve logging on deserialization failure

We now use raw JS to patch the OpenAPI spec instead of openapi-overlay.
It's a lot more flexible this way.

Kabir Oberai · 2025-05-23 19:05:02 +05:30

b5d49a63cf

Support building for iOS simulator (#74 )

Closes #68

## On any platform

You can now do

```bash
xtool dev build --triple arm64-apple-ios-simulator [--ipa]
```

To build a .app/.ipa that works on the simulator.

## On macOS

You can do

```bash
xtool dev --simulator
```

To one-shot build-and-install on the booted simulator.

Kabir Oberai · 2025-05-22 19:35:51 +05:30

3a4290c85e

Support xtool --version (#53 )

Kabir Oberai · 2025-05-21 18:16:46 +05:30

fbbd8366ca

Improve SDK handling (#40 )

* Use swift-sdk commands instead of file ops

* comment

Kabir Oberai · 2025-05-16 00:06:39 +05:30

54d03f525a

Add build --ipa (#24 )

Kabir Oberai · 2025-05-12 16:33:57 +05:30

b3c12ef4d2

Refine NewCommand

Tweak template, respect quiet flag on macOS

Kabir Oberai · 2025-05-09 11:10:15 +05:30

205041caa0

Create sdks directory if needed

Kabir Oberai · 2025-05-08 23:41:34 +05:30

307df68794

Improve macOS SDK handling

Kabir Oberai · 2025-05-07 18:03:37 +05:30

e5eb0d3c4f

Update docs

Kabir Oberai · 2025-05-06 13:47:59 +05:30

7417957dfb

More renaming and regrouping

Kabir Oberai · 2025-05-06 12:31:48 +05:30

7245b34f4f

Rename more stuff

Kabir Oberai · 2025-05-06 11:42:55 +05:30

f7ecd612fc

Rename main product

Kabir Oberai · 2025-05-06 11:30:59 +05:30

6778e66e55

SupersignCLISupport -> XToolSupport

Kabir Oberai · 2025-05-06 11:05:29 +05:30

bb21ff046a

38 Commits