Back to Terragrunt

Browse

docs/src/data/commands/browse.mdx

1.1.32.7 KB
Original Source

Keybindings

Key(s)Action
j / Move the cursor down
k / Move the cursor up
gg / homeJump to the first entry in the directory
G / endJump to the last entry in the directory
pgup / pgdnMove the cursor up or down a page
l / / enterDescend into the highlighted directory
h / Return to the parent directory
/Search the current directory
nJump to the next search match
NJump to the previous search match
escClear the search; quit when no search is active
q / ctrl+cQuit

While the search input is open, keys edit the query instead; ctrl+c still quits.

The highlighted entry is shown in blue, and its path is displayed along the top, abbreviated with ~ when it falls under your home directory.

A search matches entries in the current directory. As you type, matching entries are marked, the cursor jumps to the first match, and a match count appears along the bottom. Pressing enter keeps the search applied, leaving the marks in place so you can cycle through the matches. The search also clears on its own when you move into another directory.

Detail Pane

The detail pane shows metadata for the highlighted entry: its kind, path, module source, and its dependencies, dependents, and the files it reads (shown relative to the unit). Plain directories show a count of the units and stacks they contain.

Discovery

The browser opens immediately, reading the filesystem to fill the columns, while discovery runs in the background.

Warnings raised during discovery (a dependency cycle, for example) appear briefly as a toast in the top-right corner. A discovery failure surfaces the same way, and the browser keeps showing whatever partial results discovery produced.

browse reuses the same discovery the other discovery commands rely on, so the configurations it shows match what find and list discover.