xtool and Claude Code: Building iPhone Apps Without Xcode
By Matt Cullerton, founder of Mavric and Apso
xtool is an open-source, MIT-licensed command-line tool that builds Swift packages into iOS apps, signs them, and installs them on an iPhone from Linux, Windows (through WSL) or macOS. A TikTok from @estop845 says "Claude Code can now build entire iPhone apps" because it "just got" xtool. Claude Code can run xtool the way it runs any command-line program, but xtool has shipped releases since November 2024, contains no Claude integration, and needs considerable setup. Apps installed with a free Apple account stop working after 7 days.
What is xtool?
xtool is a cross-platform replacement for parts of Xcode, described in its repo as "Cross-platform Xcode replacement. Build and deploy iOS apps with SwiftPM on Linux, Windows, macOS." It is Kabir Oberai's project, with 406 of the repository's commits against 2 for the next contributor. He announced it on the Swift Forums on May 8, 2025, as the result of "8 years of work."
The GitHub API shows xtool-org/xtool was created on 2024-11-17. Its oldest published release, v1.2.2, is dated 2024-11-18, and releases continued through v1.22.2 on 2026-10-14. What changed in October 2026 was attention: an X post about it went viral, and the repo grew from the 7k stars shown in the video to 12,939 stars and 657 forks by 2026-10-19.
Does xtool integrate with Claude Code?
No. The xtool --help output lists setup, auth, sdk, new, dev, ds, devices, install, uninstall and launch. There is no MCP or agent command. A code search for "Claude Code" in the repo returns nothing, and the only "mcp" match is a C file about provisioning profiles.
The repo's CLAUDE.md is one line, @AGENTS.md. That file, added on 2026-09-04, tells a coding agent how to contribute to xtool itself: use swift build and swift test, and "Make sure to run make lint (swiftlint) when you're done." It does not give Claude Code any new ability.
Claude Code can drive xtool through shell commands, as it can drive make or ffmpeg. Third-party plugins that wrap xtool exist, such as 2389-research/xtool (created 2026-04-02) and stanesjenson11-lgtm/ios-app-xtool (created the day after the video), but neither comes from xtool-org.
Apple's own Xcode page says Xcode 27 "supports interacting with code using the model of your choice, including the frontier coding models and agents from Anthropic, Google, and OpenAI." That is a separate, first-party route for using Claude in iOS development.
How do you set up xtool on Linux or Windows?
The video says it needs "some initial setup, Apple's SDK, and developer authentication." The installation docs list the steps:
- Install the Swift 6.4 toolchain from swift.org.
- Install
usbmuxd, which xtool uses to talk to an iOS device. - On Windows, install WSL and configure USB passthrough with USBIPD.
- Download Xcode 27 as an
Xcode.xipfrom developer.apple.com in your browser, since the URL needs an Apple ID login. - Run
xtool setupand point it at the.xipto build a Darwin Swift SDK.
The v1.20.0 release notes say the SDK grew "from ~3 GB to ~7 GB" on disk, with xtool sdk install --slim as an option for CI.
xtool setup offers two login modes: "API Key (requires paid Apple Developer Program membership)" and "Password (works with any Apple ID but uses private APIs)." The docs suggest that for the password route "you may want to create a throwaway Apple ID to be extra cautious." Release v1.22.2 changed the login so xtool "present[s] to Apple as a Pixel 7 device" to fix authentication problems.
How do you install an app on your iPhone with xtool?
The first-app tutorial uses xtool new to create a SwiftPM package, then xtool dev. xtool then "will now connect to Apple Developer Services, register your device with your Apple ID, generate a Certificate + App ID + Provisioning Profile, sign the app, and then install it." Rerunning it after code changes gives the edit, rebuild, test loop the video describes, which suits a coding agent.
Some steps need a person with the phone:
- Connect the iPhone by USB and tap "Trust."
- Turn on Developer Mode if prompted, then rerun
xtool dev. - Approve the developer certificate under Settings, General, VPN & Device Management.
What kinds of iPhone apps can xtool build?
You write the app in Swift, as the video says, but not every app works. In the 2025 announcement, Oberai listed limits: Interface Builder is not feasible so SwiftUI is recommended, asset catalogs need workarounds, Apple-only macros such as SwiftData need extra work, app extensions were unsupported, debugging needs extra tools, and App Store deployment "remains to be done." Some of that has since changed. The docs now cover app extensions, v1.20.0 added SwiftUI macro support, and v1.20.1 added FoundationModels macros.
How long do apps installed with a free Apple ID last?
Seven days. The video promises you can go from an idea to "a working version on your phone same day," which is achievable once setup is done. Apple's membership comparison says a free account can create up to 10 App IDs and register up to 3 devices, both expiring after 7 days, and install up to 3 apps per device with provisioning profiles that expire 7 days after issue. Apple's instruction: "You'll need to rebuild and reinstall your app to your device after expiration." TestFlight and App Store Connect need the paid membership.
What the video shows
Every frame is one screenshot of an X post about xtool, with the speaker cut out on top and a caption reading "CLAUDE CAN BUILD IPHONE APPS." There is no terminal, Claude Code session, iPhone or running app.
Bottom line
xtool is a real, mature tool for building and installing iOS apps without a Mac, and Claude Code can run its commands like any CLI. Expect to install Swift, usbmuxd and a 7 GB SDK, and to tap through trust prompts on the phone. Without a paid developer account, reinstall your app every 7 days.
Sources
- xtool-org/xtool on GitHub - repo, license, commands and contributors.
- Release notes - release dates, SDK size and the login change.
- AGENTS.md - contributor instructions behind CLAUDE.md.
- Installation docs - setup steps and login modes.
- First-app tutorial - the build and install flow.
- Swift Forums announcement - author, date and limitations.
- Apple membership comparison - the 7-day free account limits.
- Xcode - Xcode 27 support for Anthropic models.
Published October 13, 2026. Based on a TikTok by @estop845. Full video notes (markdown)