Development

#Format

./scripts/format.sh

#Lint

./scripts/lint.sh

#Test

swift test

Run the docs-builder regression tests with Node 26:

node --test scripts/build-docs-site.test.mjs

#Release build and smoke test

swift build -c release
.build/release/swabble health
.build/release/swabble --help
python3 scripts/test-service-install.py .build/release/swabble

CI runs on macos-26, runs the docs-builder regression tests with Node 26, selects Xcode 26, installs SwiftFormat and SwiftLint, then runs formatting, linting, Swift tests, a release build, and CLI smoke checks.

The service smoke check uses a temporary LaunchAgents directory and synthetic versioned binaries. It checks bare and relative invocations, symlink upgrades, and uninstall/status behavior without loading a launchd agent.

#Releases

See Releasing for the GitHub Actions signing, notarization, and publication workflow.