Installation

swiftspawn is distributed as source. There’s no Homebrew tap yet and no signed binary. You build it once, copy the binary onto your PATH, and you’re done.

Requirements

• macOS 14 or later (the CLI has been tested on macOS 26).
• Swift 6.0 or later (swift --version). Comes with Xcode 16+.
• Xcode 26 if you want to open and run generated projects without adjustments.
• Optional: swiftlint and swiftformat on PATH for swiftspawn lint and swiftspawn format.

Build from source

git clone https://github.com/swiftspawn/swiftspawn-cli.git
cd swiftspawn-cli
swift build -c release

The release binary lands at .build/release/swiftspawn.

Put it on PATH

Pick one of these. Both work; the second avoids sudo.

System-wide:

sudo cp .build/release/swiftspawn /usr/local/bin/swiftspawn

User-local (no sudo):

mkdir -p ~/.local/bin
cp .build/release/swiftspawn ~/.local/bin/swiftspawn

If ~/.local/bin is not on your PATH yet, add it to your shell profile (zsh shown):

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Verify

swiftspawn version
swiftspawn doctor

doctor checks Xcode, Swift, SwiftLint, and SwiftFormat versions and reports anything missing. If everything is green, you’re ready.

Updating

There’s no auto-update. Pull the repo and rebuild:

cd swiftspawn-cli
git pull
swift build -c release
sudo cp .build/release/swiftspawn /usr/local/bin/swiftspawn

Uninstall

Remove the binary from wherever you put it:

sudo rm /usr/local/bin/swiftspawn
# or
rm ~/.local/bin/swiftspawn

Next

• Create your first project
• Read the architecture overview