Install Aliaz

Release installer

One command. A verified binary. A clean finish.

This is the primary install path. It chooses the release asset for the current macOS or Linux platform, verifies the checksum, installs the binary, and confirms that aliaz runs before optional shell and sync setup.

Recommended

curl -fsSL https://raw.githubusercontent.com/oshabana/aliaz/main/install.sh | sh

No Rust required Checksum verified Installs to ~/.local/bin

Trust details

Transparent steps, no mystery installer.

The installer is a small shell script in the repository. The trust model is intentionally inspectable: release assets and checksums come from GitHub releases, the binary is smoke-tested after installation, and uninstall keeps your local alias data.

01 Platform-matched asset

Downloads the archive for macOS or Linux on arm64 or x86_64.

02 Checksum verification

Checks the archive against checksums.txt before extracting.

03 Binary smoke test

Runs aliaz --help before reporting the install complete.

04 Reversible setup

aliaz uninstall removes shell integration and the binary while keeping your data.

Options

Script the parts you already know.

Configure shells

Set ALIAZ_INSTALL_SHELLS to one or more shell names, all, or skip. Interactive installs now use numbered menus instead of free-text shell names.

curl -fsSL https://raw.githubusercontent.com/oshabana/aliaz/main/install.sh | ALIAZ_INSTALL_SHELLS="zsh bash" sh

curl -fsSL https://raw.githubusercontent.com/oshabana/aliaz/main/install.sh | ALIAZ_INSTALL_SHELLS=skip sh

Start sync setup

Use ALIAZ_INSTALL_SYNC with login, register, or skip. Interactive installs use a menu, and non-interactive runs also need ALIAZ_SYNC_USERNAME.

curl -fsSL https://raw.githubusercontent.com/oshabana/aliaz/main/install.sh | ALIAZ_INSTALL_SYNC=login ALIAZ_SYNC_USERNAME=ada sh

Update later

Use aliaz update to download and install the latest release for the current platform.

aliaz update

Install a version

Set ALIAZ_VERSION before the shell script.

curl -fsSL https://raw.githubusercontent.com/oshabana/aliaz/main/install.sh | ALIAZ_VERSION=v0.1.5 sh

Change install dir

Use ALIAZ_INSTALL_DIR for another binary path.

curl -fsSL https://raw.githubusercontent.com/oshabana/aliaz/main/install.sh | ALIAZ_INSTALL_DIR=/usr/local/bin sh

Source

Build with Cargo when you want local development.

Install Rust if needed, then install Aliaz from the open-source GitHub repository checkout.

cargo install --path .

cargo run -- --help

cargo run -- add gs "git status"

Verify

Confirm the binary is available.

If aliaz is not found, add the install directory to your PATH and open a new shell. If you skipped shell setup, run aliaz init zsh, aliaz init bash, or aliaz init fish.

aliaz --help

Output: Manage shell aliases from a local SQLite-backed source of truth