Skip to content
HostwrightHostwright

Source install and doctor

This task is read-only. Nothing here touches the container runtime or writes state.

1. Build from source

Section titled “1. Build from source”
Terminal window
git clone https://github.com/hostwright/hostwright.git
cd hostwright
swift build

Hostwright is a dependency-free Swift package: no external SPM packages, SQLite via the system library.

2. Run the tests

Section titled “2. Run the tests”
Terminal window
swift test

You can list what exists first with swift test list, or use the repository’s scripts/test.sh helper. Passing tests on your machine are the same evidence the project itself uses for its support claims — see Testing evidence.

3. Confirm the binary answers

Section titled “3. Confirm the binary answers”
Terminal window
swift run hostwright --version
0.0.2-dev

4. Check the host

Section titled “4. Check the host”
Terminal window
swift run hostwright doctor
swift run hostwright doctor --output json

doctor runs safe local checks only: OS version, Apple silicon and macOS 26+ gate, Swift toolchain version, container executable lookup (presence only — it never runs Apple container commands), hostwright.yaml presence, state-path policy, telemetry policy, and a local resource-intelligence report.

A missing container executable is reported as a warning, not a crash. In the JSON report, benchmark dimensions that were not measured are reported explicitly as unmeasured — doctor never fabricates capacity numbers. The full check list is in Doctor checks.

Where this leaves you

Section titled “Where this leaves you”

You have a built CLI and a verdict on current host compatibility. The trusted v0.0.2 package path is still Phase 02/15 work; brew install hostwright does not exist today. See the release process and continue with Plan a single service.