Homebrew macOS · Linux

The easiest way on macOS and Linux. Tap the repo, then install.

brew tap ukroporg/tap https://github.com/ukroporg/homebrew-tap
brew install ukroporg/tap/ukrop

Cargo any platform

Build from the Rust source. Installs both ukrop and the u shortcut binary to ~/.cargo/bin.

git clone https://github.com/ukroporg/ukrop
cd ukrop
cargo install --path .

Debian / Ubuntu .deb

Build a system package with cargo-deb, then install it.

cargo install cargo-deb
cargo deb
sudo dpkg -i target/debian/ukrop_*.deb

From source dev

Clone and build a debug or release binary yourself.

git clone https://github.com/ukroporg/ukrop
cd ukrop
cargo build --release
./target/release/ukrop --help

Next: run the setup wizard

After the binary is installed, one command will import your shell history, add the shell integration to your rc file, and enable the u alias:

ukrop setup

Each step asks for confirmation, so you can skip anything. Restart your shell and you're ready.

Continue to Quickstart →

Requirements

Everything else — SQLite, fuzzy matcher, TUI — is bundled into the binary.

Upgrading

Homebrew: brew upgrade ukrop. Cargo: rerun cargo install --path . --force from the repo. The database schema migrates automatically on startup.