Install

Memzoi v0 is installed through release binaries or from a source checkout. Homebrew and crates.io packages are roadmap items.

Install methods

Method	Status	Command	Notes
Install script	Available now	curl -fsSL https://raw.githubusercontent.com/Zokiio/Memzoi/main/scripts/install.sh | MEMZOI_REF=v0.1.0 sh	Downloads the v0.1.0 release binary for supported platforms.
Windows install script	Available now	$env:MEMZOI_REF="v0.1.0"; irm https://raw.githubusercontent.com/Zokiio/Memzoi/main/scripts/install.ps1 | iex	Downloads the v0.1.0 release binary for supported platforms.
Source checkout	Available now	make install	Requires Cargo; installs memzoi and memzoi-mcp.
crates.io	Planned	cargo install memzoi-cli and cargo install memzoi-mcp	Publish memzoi-core first; dependent package checks need it in the crates.io index.
GitHub release binary	Available now	Download from GitHub Releases	The install scripts select the matching release asset automatically.
Homebrew	Future	TBD	Defer until at least one GitHub release exists.

Install Script

Mac or Linux:

curl -fsSL https://raw.githubusercontent.com/Zokiio/Memzoi/main/scripts/install.sh | MEMZOI_REF=v0.1.0 sh

Windows:

$env:MEMZOI_REF = "v0.1.0"
irm https://raw.githubusercontent.com/Zokiio/Memzoi/main/scripts/install.ps1 | iex

By default, the install script downloads the latest GitHub release binary, verifies its SHA-256 checksum, and installs into ~/.local/bin on Mac/Linux. On Windows, it installs under %LOCALAPPDATA%\Programs\Memzoi\bin and updates the user Path.

To install the version matching this documentation:

curl -fsSL https://raw.githubusercontent.com/Zokiio/Memzoi/main/scripts/install.sh | MEMZOI_REF=v0.1.0 sh

Set MEMZOI_REF=main to install from the current main branch instead; that source install path requires Cargo.

Local Cargo Install

From the Memzoi repo:

make install

The install script runs:

cargo install --path crates/memzoi-cli --locked
cargo install --path crates/memzoi-mcp --locked

It installs the primary binaries:

• memzoi
• memzoi-mcp

Release Packaging Note

When validating or publishing crates, handle memzoi-core first. memzoi-cli and memzoi-mcp declare versioned dependencies on memzoi-core, so their cargo package checks can fail until the matching memzoi-core version is available in the crates.io index.

Verify Install

memzoi --version
memzoi-mcp --version
memzoi doctor

If the Mac/Linux binaries install successfully but the shell cannot find them, add the install directory to PATH:

export PATH="$HOME/.local/bin:$PATH"

If MEMZOI_INSTALL_DIR is set, use that directory instead.

Developer Mode

You can run the binaries from source without installing:

cargo run -p memzoi-cli -- --help
cargo run -p memzoi-mcp -- --help

Developer mode is useful while editing the repo. The installed CLI path is better for testing real agent integrations because MCP clients usually expect a stable binary on PATH.