Install

Current release: v0.2.21 — every download below points at releases/latest, so the links always follow the newest build.

mnml ships native binaries for macOS, Linux, and Windows via cargo-dist. All three are first-class platforms — the full test suite (1196 unit + 222 e2e) runs green on every push across ubuntu-latest, macos-latest, and windows-latest. For the finer points (target choices, Git Bash on Windows, source-build prerequisites), see Platform support.

Mac

brew install chris-mclennan/tap/mnml

.tar.xzmacOS 11+ · portable

.tar.xzportablex64 ARM64
installer.shcurl | shscript

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

.tar.xzportablex64 ARM64
installer.shcurl | shscript

No .deb / .rpm? We ship a portable tarball plus cargo install mnml-rs; distro-native packages weren’t worth the release surface for a single-binary editor. If you want one, file an issue.

Windows

winget install mnml

.zipWindows 10/11 · x64 · portable

.zipportablex64
installer.ps1irm | iexscript
.msiwinget sourcex64

Build from source

Prerequisites — a Rust toolchain (via rustup), zig 0.16.0, and git on PATH. The zig + git pair drive mnml-libghostty-vt-sys’s source-build fallback, which git-clones ghostty at a pinned commit and compiles libghostty-vt on first build. Older zig 0.15.x won’t work.

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

On Windows, build explicitly for the -pc-windows-gnu target (see Platform support for the rationale — upstream libghostty-vt doesn’t support MSVC):

rustup target add x86_64-pc-windows-gnu
cargo build --release --target x86_64-pc-windows-gnu

Or via crates.io (slow — requires the Rust toolchain plus the same zig + git prerequisites):

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