Agent BayAgent Bay
Agent Bay
Start

Install & build

Download a desktop build from the CDN (auto-update, embedded sidecar), or clone the repo and run from source. The terminal works with AI disabled and without any cloud account.

Requirements

  • Rust 1.77+ (from source only)
  • Node 20+ (from source only — downloaded builds embed the Node sidecar runtime)
  • pnpm 9+ (from source)
  • macOS, Linux, or Windows

Commands

Install dependencies
pnpm install
Native app (Vite + Tauri window)
pnpm dev
Rust tests
cargo test --workspace
TypeScript tests
pnpm -r test

Notes

  • Prefer the Download button on the homepage — it goes through downloads.agentbay.hazeljs.com so we can count installs.
  • In-app Updates checks downloads.agentbay.hazeljs.com/releases/latest/latest.json (signed).
  • Until Apple notarization / Windows Authenticode are configured, macOS may require right-click → Open the first time, and Windows SmartScreen may warn on an unsigned installer.
  • Use the native window from pnpm dev — not the Vite browser tab. PTY, Keychain, and Agent OS only exist in the Tauri shell.
  • AI is optional forever. First-run does not require a provider or account.
  • Companion CLI (temporary name): pnpm --filter agentterm doctor | adapters | plugin list | mcp list