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 installNative app (Vite + Tauri window)
pnpm devRust tests
cargo test --workspaceTypeScript tests
pnpm -r testNotes
- 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