Install Composal on macOS

Normal local checkout

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

curl -fsSL https://dl.composal.ai/install.sh | sh

The installer needs no sudo and configures your shell’s PATH automatically. Open a new terminal if prompted, then continue:

com login
com 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.

com 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.

com daemon status --format json
com daemon capabilities --format json
com status

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