Ayran - Fuzzy Directory Navigation Tool

https://github.com/user-attachments/assets/16c80db4-940b-4cf7-9768-7c9328fda4aa

Purpose

• Provides fuzzy directory navigation and completion for shell environments.
• Simple prefix-based matching with ambiguity detection.

Usage

./target/release/ayran [--complete] <base_dir> [args...]

Arguments

Examples

./target/release/ayran /home/user/documents pro
./target/release/ayran --complete /home/user/documents pr

Usage Example

Add this to your ~/.zshrc:

# source ~/.config/zshrc/scripts/logging.sh
local _NAV='PATH to the executable'

function conf() {
  local dir=$($_NAV "$HOME/.config/" "$@") || return 1
  clear && cd "$dir"
  # cmd "eza $dir"
  eza --long --header -a --icons --git --group-directories-first --group
}

Then use it like:

• conf zs - Navigate to ~/.config/zshrc
• conf nv - Navigate to ~/.config/nvim
• conf hy - Navigate to ~/.config/hypr

Tab Completion

#compdef conf

local -a opts
local target_dir=$HOME/.config
local _NAV='Path to executable'

opts=($(_NAV --complete $target_dir "${(@)words[2,CURRENT]}"))
compadd -S '' -a opts

Requirements

• Rust 1.75 or later

Installation

Arch Linux

cargo install ayran

License

This project is licensed under the MIT License.