Installation

Get Shell Buddy

Pick whichever route fits your setup.

crates.io

$ cargo install shell-buddy

Homebrew

$ brew install hjelev/tap/sb

From source

$ git clone https://github.com/hjelev/sb.git $ cd sb $ cargo install --path .

Releases

Prebuilt binaries and an auto-installer script are available in GitHub Releases — the fastest setup without building from source.

Shell integration — change directory on exit

Add this function to your ~/.bashrc or ~/.zshrc so your shell follows wherever you navigate:

sb() {
    "$HOME/.cargo/bin/sb" "$@"
    if [ -f /tmp/sb_path ]
    then
        cd "$(cat /tmp/sb_path)"
        rm -i -f /tmp/sb_path
    fi
}
Integrations

Optional tools, auto-detected

Only two requirements — less and $EDITOR. Everything else is optional and degrades gracefully.

less $EDITOR git bat glow mmdflux jnv csvlens hexyl chafa viu sox pdftotext asciinema links delta hexedit vidir tmux zip / unzip tar 7z rar / unrar fuse-zip archivemount age sshfs rclone rg fzf xclip / wl-copy