Installation and build

Build from source

From repository root:

This produces a debug build for fast local iteration.

Run locally

Show command-line help:

Launch the desktop app:

Release build with bundled runtime

The bundle-runtime feature embeds the agent runtime archive into the binary. This is disabled by default to keep development builds fast.

Without bundle-runtime, caretta loads runtime assets from crates/agent-runtime/node_modules at runtime.

Formatting and lint checks

Run these before creating a pull request:

Workspace tests

Run the full suite:

Run a targeted tracker test subset while iterating:

Optional verification scripts

Install local pre-commit hooks:

Run smoke checks when changing install or CLI behavior:

Build output expectations

• cargo build compiles all crates in debug mode.

• cargo build --release --features bundle-runtime emits a standalone binary.

• cargo test --workspace validates cross-crate behavior.

• cargo clippy ... -D warnings ensures no lint warnings are left unresolved.