Install CLI or Desktop

Same local library either way. Start in the terminal, or use the desktop app with an embedded agent sidecar.

npm i -g harnesstapNeeds Node 22 or newer.

HarnessTap Desktop

Tauri app with a local ht-agent sidecar. Same library as the CLI at ~/.harnesstap.

Choose your platform

Latest release: v1.6.2

All desktop builds

Other OS and architecture installers from the same latest release.

macOS

Windows

Linux

All releases on GitHub, including checksums.

HarnessTap CLI

Local apply, env swap, and drift-aware sync. Needs Node 22 or newer.

Recommended: npx (no global install)

npx harnesstap@latest init

npm global

npm i -g harnesstap
ht init

Bun (alternative)

bun install -g harnesstap
bunx harnesstap@latest init

ht is shorthand for harnesstap. Continue with CLI getting started for init, first apply, and the scan/compose/publish loop.

After you install

Desktop setup, workspaces, and how the app shares state with the CLI are in the docs.

Desktop documentation