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 confirm the build.

3. Confirm the binary answers

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

This prints the current development version.

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 check only), 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 reports only measured values. 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. Hostwright installs from source today; brew install hostwright does not exist yet. Continue with Plan a single service.