Installation

Install mentu

Homebrew (recommended)

brew install mentu

Direct download

Download the latest release from the mentu releases page and place the binary in your PATH.

Build from source

git clone https://github.com/mentu-ai/mentu-engine.git
cd mentu-engine
swift build -c release

Install the built binary:

rm -f ~/.local/bin/mentu
cat .build/release/MentuEngine > ~/.local/bin/mentu && chmod +x ~/.local/bin/mentu

Codesign for Keychain access

codesign --force --sign - --identifier com.mentu.engine ~/.local/bin/mentu

This gives the binary a stable identity (com.mentu.engine) so macOS Keychain remembers access permissions across rebuilds. Without it, mentu vault prompts for Keychain access on every invocation.

Verify

mentu --version

This should print the version string. If it prints nothing or errors, re-run the install steps.

Node.js requirement

The scripting SDK requires Node.js 20+. Scripts are executed in a V8 sandbox spawned by Node.js.

node --version  # Should print v20.x or higher

If you only use the CLI for CIR queries, vault operations, and sequence execution, Node.js is not required. It is only needed for mentu script run.

Directory structure

After installation, mentu uses the following paths: