Install

mnml ships native binaries for macOS, Linux, and Windows via cargo-dist.

Mac

.dmgmacOS 11+

brew install chris-mclennan/tap/mnml

• .dmgx64ARM64
• .pkgx64ARM64
• .tar.xzx64ARM64

Linux

.tar.xzStatic binary · x64 / ARM64

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/chris-mclennan/mnml/releases/latest/download/mnml-rs-installer.sh | sh

• .debDebian, Ubuntux64ARM64
• .rpmRed Hat, Fedora, SUSEx64ARM64
• .tar.xzportablex64ARM64
• installer.shcurl | shscript

Windows

.msiWindows 10/11 · x64

irm https://github.com/chris-mclennan/mnml/releases/latest/download/mnml-rs-installer.ps1 | iex

• .msix64
• .zipportablex64

Build from source

git clone https://github.com/chris-mclennan/mnml
cd mnml
cargo build --release
./target/release/mnml

Or via crates.io (slow — requires the Rust toolchain):

cargo install mnml-rs

The crate is mnml-rs; the binary it installs is mnml.

Nerd Font

A Nerd Font is recommended for devicons and powerline glyphs. JetBrainsMono Nerd Font is a good default. Without a Nerd Font, run mnml --ascii (or set [ui] ascii_icons = true in your config) for a plain-text fallback.

Verify

mnml --version

If your shell can’t find mnml, you may need to restart it (the installer puts mnml on PATH via your shell profile).