🥾 walk

Walk — a terminal navigator.

Why another terminal navigator? I wanted something simple and minimalistic. Something to help me with faster navigation in the filesystem; a cd and ls replacement. So I build walk. It allows for quick navigation with fuzzy searching, cd integration is quite simple. And you can open vim right from the walk. That's it.

Install

brew install walk

pkg_add walk

pacman -S walk

go install github.com/antonmedv/walk@latest

Or download prebuild binaries.

Put the next function into the .bashrc or a similar config:

Bash/Zsh	Fish	PowerShell
walk () { # export WALK_EDITOR=nano # export WALK_MODE=1 # for using detail local result=$(command walk "$@") [ -n "$result" ] && cd -- "$result" }	function lk set loc (walk $argv); and cd $loc; end	function lk() { cd $(walk $args) }

Bash/Zsh

Fish

PowerShell

walk () {
	# export WALK_EDITOR=nano
	# export WALK_MODE=1 # for using detail
	local result=$(command walk "$@")
	[ -n "$result" ] && cd -- "$result"
}

function lk
  set loc (walk $argv); and cd $loc;
end

function lk() {
  cd $(walk $args)
}

Now use lk command to start walking.

Usage

Key binding	Description
`Arrows`, `hjkl`	Move cursor
`Enter`	Enter directory
`Backspace`	Exit directory
`Space`	Toggle preview
`Esc`, `q`	Exit with cd
`Ctrl+c`	Exit without cd
`/`	Fuzzy search
`dd`	Delete file or dir
`y`	yank current dir

The EDITOR or WALK_EDITOR environment variable used for opening files from the walk.

export EDITOR=vim

Preview mode

Press Space to toggle preview mode.

Delete file or directory

Press dd to delete file or directory. Press u to undo.

Display icons

Install Nerd Fonts and add --icons flag.

Image preview

No additional setup is required.

Become a sponsor

Every line of code in my repositories 📖 signifies my unwavering commitment to open source 💡. Your support 🤝 ensures these projects keep thriving, innovating, and benefiting all 💼. If my work has ever resonated 🎵 or helped you, kindly consider showing love ❤️ by sponsoring. 🚀 Sponsor Me Today! 🚀

License

MIT

kice / walk