Skip to content
HostwrightHostwright

Install from source

Hostwright is in active development and not production ready.

Requirements

Section titled “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

Section titled “Build and verify”
Terminal window
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

This prints the current development version. There is no release tag to check out yet; build from the default branch.

Try the current safe surface

Section titled “Try the current safe surface”
Terminal window
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:

Terminal window
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 a source tree, not an installed package. Managed install, upgrade, rollback, repair, and uninstall are planned. Until then, preserve or clean runtime and state resources explicitly.