Files View

A read-only file browser rooted at the repository, laid out like yazi: the left column shows the parent directory, the middle the current one, and the right a preview of the selected entry — syntax-highlighted text, or a listing for directories. .git internals are hidden and symlinks are marked. Entries get Nerd Font icons by file type; if your terminal font is not a Nerd Font, put icons "none" in your config.

Image previews

Images (PNG / JPEG / GIF / WebP) are previewed in the pane, with their format, dimensions, size and the renderer in use on the first line. In terminals with a graphics protocol (Kitty, WezTerm, Ghostty, iTerm2, or Sixel-capable ones such as foot) the image is drawn at full resolution; elsewhere it falls back to unicode half-blocks. image-preview "halfblocks" in the config skips the terminal detection and "none" shows only the metadata. Images over 20 MB are not decoded.

Markdown previews

Markdown files (.md / .markdown, by extension) are rendered in the preview: headings, emphasis, lists, task lists, code and GFM tables, with tables fitted to the pane width and reflowed on resize. A YAML front matter block at the top is kept verbatim in a dim style. m toggles between the rendered form and the raw highlighted text (the pane title shows markdown / raw); the markdown-preview config node picks the default.

Reading long files

Inside the preview, h / l (or ← / →) scroll long lines horizontally — nothing wraps, and the line number gutter stays put. / searches the file contents (case-insensitive) over what is shown: the rendered text in Markdown mode, the raw lines otherwise; matches are highlighted, n / N step through them and the view scrolls both ways so the current match is visible. Esc clears the search, then returns to the file list. Image previews have nothing to search.

Opening files outside vig

Beyond previewing, the Files view can hand a file to another program — this is the only view with an “open with” concept:

• e opens the selected file in your external editor ($EDITOR).
• o opens the selected file or directory with the OS default application (open / xdg-open / explorer).
• O prompts for an application name and opens the entry with it (open -a <app> on macOS).

Key bindings

Constraints

• The browser is rooted at the repository — it does not wander above the repository root.
• Strictly read-only: no create, rename, delete, copy, or move. Handing a file to $EDITOR or the OS opener is as far as it goes.