LinuxCommandLibrary

broot

Interactive directory tree navigator

TLDR

Install the br shell function

$ broot --install
copy
Start interactive navigation
$ broot
copy
Show file sizes
$ broot -s
copy
Show permissions
$ broot -p
copy
Show only directories
$ broot -f
copy
Show hidden files
$ broot -h
copy
Start in specific directory
$ broot path/to/directory
copy

SYNOPSIS

broot [options] [path]

DESCRIPTION

broot is an interactive directory tree navigator that provides a better way to navigate directories. It offers fuzzy searching, file previews, and can integrate with the shell via the br function.

PARAMETERS

--install

Install or reinstall the br shell function
-s, --sizes
Display file and directory sizes
-p, --permissions
Display file permissions
-f, --only-folders
Show only directories (no files)
-h, --hidden
Show hidden files and directories
-d, --dates
Display file modification dates
-g, --git-status
Show git status of files
-w, --whale-hierarchical
Show hierarchical directory sizes
--cmd COMMAND
Execute command on startup
-c, --conf PATH
Use specified configuration file
--outcmd PATH
Write command to file for shell integration

CONFIGURATION

~/.config/broot/conf.hjson

Main configuration file in Hjson format. Controls key bindings, verbs, skin, and display settings.
~/.config/broot/conf.toml
Alternative configuration file in TOML format. Used instead of conf.hjson if present.

CAVEATS

The br shell function is recommended over direct broot invocation for changing directories. Install it with --install and use br instead of broot for full shell integration.

HISTORY

broot was created as a modern alternative to tree and cd, providing fuzzy search, visual navigation, and efficient handling of large directory trees.

SEE ALSO

tree(1), ranger(1), lf(1), nnn(1)

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard

> TERMINAL_GEAR

Curated for the Linux community