broot

# Homebrew (macOS/Linux)
brew install broot

# Cargo (Rust)
cargo install broot

# Pacman (Arch Linux)
sudo pacman -S broot

# APT (Debian/Ubuntu) - install via snap
sudo snap install broot

# Install shell integration on first launch
broot --install

# ~/.config/broot/conf.hjson or ~/.config/broot/conf.toml

{
    # Default flags (show hidden files, show Git info, etc.)
    default_flags: "gh"

    # Mode settings
    modal: false

    # Date format
    date_time_format: "%Y/%m/%d %H:%M"

    # Special path settings
    special_paths: {
        "~/.config": { show: true }
        "node_modules": { show: never }
        ".git": { show: never }
    }

    # File size display
    show_selection_mark: true
    show_matching_characters_on_path_searches: true

    # Color settings
    syntax_theme: "MochaDark"
}

# Keybindings (verbs)
[[verbs]]
invocation = "edit"
shortcut = "e"
key = "enter"
apply_to = "file"
execution = "$EDITOR {file}"

[[verbs]]
invocation = "create {subpath}"
shortcut = "c"
execution = "touch {directory}/{subpath}"

[[verbs]]
invocation = "mkdir {subpath}"
shortcut = "md"
execution = "mkdir -p {directory}/{subpath}"

# ~/.config/broot/conf.hjson - Custom verbs

[[verbs]]
# Show git diff
invocation = "gd"
execution = "git diff {file}"
leave_broot = false

[[verbs]]
# Search with ripgrep
invocation = "rg {args}"
execution = "rg {args}"

[[verbs]]
# Copy (to other panel)
invocation = "cp"
key = "ctrl-c"
execution = "cp -r {file} {other-panel-directory}"

[[verbs]]
# Move (to other panel)
invocation = "mv"
key = "ctrl-x"
execution = "mv {file} {other-panel-directory}"

[[verbs]]
# Move to trash
invocation = "trash"
key = "ctrl-d"
execution = "trash {file}"
leave_broot = false

# ~/.bashrc or ~/.zshrc

# broot shell integration (auto-generated by broot --install)
source ~/.config/broot/launcher/bash/br

# When launching broot with the br command,
# the directory is preserved on exit

# Custom alias
alias tree='br -sdp'  # Use as directory tree