Source install and doctor

This task builds source and runs local checks. It does not apply a workload. Authenticated CLI checks require daemon setup; bootstrap creates local identity and state, and the daemon can reconcile its configured workload.

1. Build from source

git clone https://github.com/hostwright/hostwright.git
cd hostwright
swift build

The package uses pinned SwiftPM dependencies, including Yams for bounded YAML decoding and Containerization behind its helper. SQLite uses the system library.

2. Run the tests

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

swift run hostwright --version

This prints the current development version.

4. Check the host

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 and supported version probes, 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

You have a built CLI and a verdict on current host compatibility. Hostwright installs from source or the unsupported vendor tap. Literal brew install hostwright is unavailable; Homebrew-core submission is deferred. Continue with Plan a single service.