Quickstart

Walk Quickstart

Terminal file manager - Navigate directories and execute files.

Installation

# Via Go
go install github.com/antonmedv/walk@latest

# Via Homebrew
brew install walk

# Download from releases
# https://github.com/antonmedv/walk/releases

Basic Usage

# Open walk in current directory
walk

# Open at specific path
walk /path/to/directory

# Exit and cd to last directory (use with alias)
walk --help

Key Bindings

• j/k or ↓/↑ - Navigate down/up
• h/l or ←/→ - Parent directory/enter
• Enter - Open file or directory
• Space - Toggle preview
• q / Esc - Quit
• / - Search
• ~ - Go to home directory
• - - Go to previous directory

Features

• Minimal and fast
• Works with any shell
• Preview mode for files
• Search functionality
• Integrates with cd (see below)
• No configuration needed

Shell Integration (cd on exit)

To change directory when exiting walk, add this to your shell config:

Bash/Zsh

function w() {
  walk "$@" && cd "$(walk --print-path)"
}

Fish

function w
  walk $argv && cd (walk --print-path)
end

Then use w instead of walk to navigate and auto-cd.

Tips

• Keep it simple - walk is designed to be minimal
• Use with shell aliases for common directories
• The --print-path flag outputs the last visited directory for scripting