Installation

From Source¶

git clone https://github.com/pdg-global/rusty.git
cd rusty
cargo build --release

The binary is produced at ./target/release/rusty. Move it somewhere on your PATH:

# macOS / Linux
sudo cp ./target/release/rusty /usr/local/bin/

# Or add the target directory to your PATH
export PATH="$PWD/target/release:$PATH"

Platform Support¶

Platform	Architecture	Status
macOS	aarch64 (Apple Silicon)	Fully supported
macOS	x86_64 (Intel)	Fully supported
Linux	x86_64	Fully supported
Linux	aarch64	Fully supported
Windows	x86_64	Supported (TUI requires Windows Terminal)

Dependencies¶

Rusty builds as a single statically compiled binary with no runtime dependencies. All native dependencies (OpenSSL, etc.) are vendored via the Rust crate ecosystem.

Build Dependencies¶

Rust toolchain 1.75+ (edition 2021)
A C compiler (for some vendored C libraries on Linux)

Install Rust via rustup:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Verifying the Installation¶

After installing, verify Rusty works:

rusty --help

This displays all available CLI flags and run modes.

Shell Completions¶

Rusty supports shell completions via clap. Generate them for your shell:

# Bash
rusty --completions bash > ~/.bash_completion.d/rusty

# Zsh
rusty --completions zsh > ~/.zfunc/_rusty

# Fish
rusty --completions fish > ~/.config/fish/completions/rusty.fish

Note

If shell completions are not yet wired up, you can request them as a feature on GitHub.