An interactive terminal AI agent built with Ink.
1. Direct Binary Install from Release Page (Easiest way)
Download the binary for your platform from the Release Page, then in your terminal:
cd downloaded-folder && ./harness-linux-x64Replace harness-linux-x64 with the downloaded binary name (e.g. harness-darwin-arm64, harness-windows-x64.exe).
No dependencies required.
Bun is required for this method. Install it first if you don't have it:
curl -fsSL https://bun.sh/install | bashThen clone and run:
bun add -g @venomhare/harness-cli
harnessThe CLI stores per-provider API keys locally in ~/.harness-cli/secrets.json (created with 0600 permissions on first run). You will be prompted for the API key on first launch via the interactive TUI, or you can pre-seed it:
echo '{ "openai": "sk-..." }' > ~/.harness-cli/secrets.json
chmod 600 ~/.harness-cli/secrets.json- Linux: Make sure your download is
chmod +x'd before running, e.g.chmod +x harness-linux-x64 && ./harness-linux-x64. If the binary was downloaded from outside thePATHdirectory,chmod +xis required before first use. - macOS (Apple Silicon / Intel): To suppress Gatekeeper warnings for the downloaded binary on first run, remove the quarantine attribute:
(use the matching
xattr -d com.apple.quarantine harness-darwin-arm64
darwin-x64binary for Intel Macs) - Windows:
- Important: Install Bun using the official installer (
powershell -c "irm bun.sh/install.ps1|iex"), not via npm (npm install -g bun). The npm-installed version is a PowerShell script and will not work with npm-generated CLI wrappers. - For the direct
.exedownload, run it from a directory where you have write permission or select Yes if SmartScreen prompts you.
- Important: Install Bun using the official installer (
git clone https://github.com/VenomHare/harness-cli
cd harness-cli
bun install
bun run build:binary:all # or build:binary for current platform