AgentHarbor CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Commands

npm install                       # install JS deps
npm run tauri dev                 # full dev: Vite on :1420 + Tauri window, Rust hot-restart
npm run build                     # tsc && vite build (frontend only)
npm run test:regression           # npm run build + cd src-tauri && cargo test  (the CI gate)

Targeted checks:

npx tsc --noEmit                                    # frontend type check (CI uses this)
cd src-tauri && cargo test <name>                   # single Rust test
cd src-tauri && cargo clippy --all-targets -- -D warnings   # lint Rust (CI runs this, continue-on-error)
cd src-tauri && SKIP_VERSION_BUMP=1 cargo build     # build check without bumping the patch version

Version-bump side effect. npm run build runs scripts/bump-build.cjs as a prebuild step and increments the patch in package.json, src-tauri/tauri.conf.json, and src-tauri/Cargo.toml in lockstep. Set SKIP_VERSION_BUMP=1 whenever you don't want that (CI sets it on plain build checks; the signed-release flow also sets it — see docs/build-and-release.md).

Signed/notarized builds, release tagging, and the latest.json updater feed are documented in docs/build-and-release.md; do not run them speculatively.

Architecture

Tauri 2 desktop app. React 19 + TypeScript + Vite + Zustand (src/) talks over Tauri IPC to a Rust backend (src-tauri/src/). Bundle target is macOS aarch64 + Windows x64; no Linux packaging.

Two Tauri windows

src/App.tsx branches on getCurrentWindow().label:

• main — the full app (sidebar + routes under BrowserRouter).
• tray-popover — a separate Tauri window owned by src-tauri/src/tray.rs, renders <TrayPopover /> only. It emits navigate-to events that the main window picks up via NavigateListener (also shows/focuses the main window).

Adapter trait — the core abstraction

src-tauri/src/adapters/traits.rs defines AgentAdapter (id, name, capabilities, detect, read_config, diff, deploy, remove, managed_paths). One implementation per provider (claude_code, cursor, windsurf, gemini, copilot, antigravity, vscode, codex) lives next to it. AdapterRegistry::new() in adapters/mod.rs instantiates the full list — adding a provider means adding it there.