Install from source

Hostwright 0.0.2-dev is not production ready.

Package-manager truth

brew install hostwright does not exist today. Phase 02 owns a vendor tap, signed/notarized archives, and a .pkg; Phase 15 submits Homebrew core. The future guaranteed fallback is brew install hostwright/tap/hostwright, but that command is not available until its distribution evidence passes.

Requirements

• Apple silicon Mac.
• macOS 26 or newer for the current package target.
• Swift 6.2-compatible toolchain.
• Apple container only for live runtime commands.
• Git.

Build and verify

git clone https://github.com/hostwright/hostwright.git
cd hostwright
swift build
swift test
scripts/integration.sh
swift run hostwright --version
swift run hostwright capabilities --json

Expected development version:

0.0.2-dev

Do not check out a v0.0.2 tag until the GA gate exists and passes.

Try the current safe surface

swift run hostwright init
swift run hostwright validate
swift run hostwright plan --output json
swift run hostwright doctor --output json

Runtime-backed/state-writing commands require Apple container as applicable and an explicit database path:

swift run hostwright status --state-db /tmp/hostwright.sqlite
swift run hostwright logs api --state-db /tmp/hostwright.sqlite
swift run hostwright events --state-db /tmp/hostwright.sqlite
swift run hostwright cleanup --state-db /tmp/hostwright.sqlite --dry-run

The current checkout is not an installed package, and deleting it is not a Hostwright uninstall. Phase 02 implements ownership-aware install, upgrade, rollback, repair, and uninstall; until then preserve or clean runtime/state resources explicitly.