> ## Documentation Index
> Fetch the complete documentation index at: https://zju-a00451d9-feat-personal-agent-team.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# macOS Dev Setup

# 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

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

## Install Dependencies

```bash theme={null}
pnpm install
```

## Build and Check

```bash theme={null}
pnpm build
pnpm check
pnpm lint
```

## Run the Gateway

```bash theme={null}
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.