SweetPad

xcodebuild for humans and agents.

A command-line tool that builds, runs, debugs, and tests apps for iOS, macOS, etc. without opening Xcode. It works with Xcode projects and workspaces, Tuist, XcodeGen, and Swift packages.

sweetpad-demo-readme.mp4

brew install sweetpad-dev/tap/sweetpad

cd MyApp
sweetpad run                        # build, install, launch, and stream logs
sweetpad run --on "iPhone 16 Pro"   # pick a simulator or device
sweetpad test --on booted           # test on the simulator that is already booted

The first run asks for a scheme and a destination and saves the answers. While run is active, press r to rebuild or q to quit.

Features

• Pleasant to use: short commands, prompts in place of required flags, and built-in help for every command.
• Short build output: a small app's build prints 7 lines, where xcodebuild prints 350.
• Destinations: simulators, connected devices, and the Mac, picked by name with --on.
• Testing: run a single test, rerun failures, retry flaky tests, and export coverage and JUnit reports.
• Autocomplete: sweetpad bsp init sets up SourceKit-LSP for Neovim, Zed, Helix, and Emacs.
• Hot reload: sweetpad run --hot applies saved Swift changes without restarting the app.
• Debugging: breakpoints in Neovim, Zed, or VS Code through sweetpad dap, plus scripted lldb sessions and structured crash reports.
• Scripts and CI: JSON output and specific exit codes on every command.
• Agent skills: instructions that teach coding agents to use the CLI.

More

Documentation: sweetpad.hyzyla.dev

There is also a VS Code extension. The CLI does not depend on it.

Sponsor: GitHub Sponsors · Buy Me a Coffee

License: MIT