Install Vex on macOS

Install Vex on macOS and choose a normal checkout or an optional MacFUSE-backed virtual mount.

On this page

Normal local checkout

The standard macOS path needs no kernel extension or filesystem driver. Install the CLI, sign in, and clone a repository.

Terminal

curl -fsSL https://dl.vex.sc/install.sh | sh
vex login
vex clone <org>/<repo>

This is the complete supported path for source control, change review, landing, hosting, registry workflows, and coding-agent setup.

MacFUSE virtual mount

Use an optional virtual working copy when you deliberately need a daemon-backed filesystem view. Install MacFUSE, then clone with the virtual filesystem option.

Terminal

vex clone <org>/<repo> --fs virtual

The virtual path depends on local host capability. If it is unavailable, use a normal checkout rather than trying to work around the operating-system boundary.

Verify and recover

Use the CLI to check the local daemon and the current repository state.

Terminal

vex daemon status --format json
vex daemon capabilities --format json
vex status

If a virtual mount is unavailable or fails, clone normally and continue the same Vex workflow. See CLI configuration for local profiles and source control for repository workflows.