Install Wrenlift
Three paths: a one-line installer, a prebuilt binary download,
or cargo install from source. The one-liner is the
quickest and ships with the matching hatch CLI and
wlift-lsp language server.
One-liner
Drops wlift, hatch, and
wlift-lsp into ~/.local/bin,
SHA256-verified against the latest GitHub release.
curl -fsSL https://wrenlift.com/install.sh | bash
Make sure ~/.local/bin is on your PATH.
Most shell setups already include it; if yours doesn't:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc # or ~/.bashrc
exec $SHELL
Installer knobs
The installer respects three env vars:
| Variable | Default | Purpose |
|---|---|---|
WLIFT_VERSION | latest release | Pin a tag, e.g. v0.1.19. |
INSTALL_DIR | ~/.local/bin | Install location. Use /usr/local/bin for system-wide (no sudo elevation). |
WLIFT_REPO | wrenlift/WrenLift | Override the GitHub slug. Useful for testing forks. |
WLIFT_VERSION=v0.1.19 INSTALL_DIR=/usr/local/bin \
curl -fsSL https://wrenlift.com/install.sh | bash
Prebuilt binary
Every tagged release ships per-platform tarballs on the
GitHub releases
page. Pick the asset that matches your machine, untar, and
drop the binaries somewhere on PATH.
| Platform | Asset suffix |
|---|---|
| macOS · Apple Silicon | -aarch64-apple-darwin.tar.gz |
| macOS · Intel | -x86_64-apple-darwin.tar.gz |
| Linux · x86_64 | -x86_64-unknown-linux-gnu.tar.gz |
| Linux · ARM64 | -aarch64-unknown-linux-gnu.tar.gz |
| Windows · x86_64 | -x86_64-pc-windows-msvc.zip |
From source
Builds the runtime + CLI against the current state of
main. Requires Rust 1.79+.
cargo install --git https://github.com/wrenlift/WrenLift.git \
--bins --locked \
wren_lift
Pin a commit with --rev <sha> for reproducible
installs.
Verify
wlift --version
hatch --version
Both should print a version string. If the shell can't find
wlift, double-check that INSTALL_DIR is on
PATH.
Uninstall
The installer doesn't track files; uninstall is manual:
rm "$HOME/.local/bin/wlift" "$HOME/.local/bin/hatch" "$HOME/.local/bin/wlift-lsp"
rm -rf "$HOME/.hatch" # registry cache + credentials (optional)
Next steps
- Quick start — write your first program, learn the common CLI flags.
- WebAssembly — embed the runtime in a webpage.
- Browse Hatch packages — the standard library.