macOS Developer Setup

The public repository currently ships the Gateway/CLI runtime. It no longer contains a native Swift app build tree or packaging scripts.

Prerequisites

Node.js 24 and pnpm: recommended for the Gateway, CLI, Control UI, and tests.
Xcode command line tools: useful for native dependencies and macOS shell tooling.

pnpm install

pnpm build
pnpm check
pnpm lint

velaclaw gateway start
velaclaw gateway status

If you are developing from the source checkout instead of a global install, use the package scripts or node velaclaw.mjs from the repository root.