mdnav
A keyboard-driven file explorer for the terminal. Browse any directory, preview files as you navigate, manage your repo and share diagrams — all without touching the mouse.
You're already in the terminal. Why open Explorer or Finder?
Features
Keyboard first
No mouse. No friction.
Navigate any directory with hjkl, jump between panels with Tab, and run any action from the command palette with :. Fully keyboard-driven.
Instant preview
See files as you move.
The right panel updates as you navigate. Markdown is rendered, code is syntax-highlighted, Mermaid diagrams are detected automatically.
Git built-in
Commit without switching.
Status, diff, log, commit, push and pull — all accessible from inside the explorer. Your repo is always a keystroke away.
Bookmarks
Jump to where you work.
Pin any directory with Shift+B. Bookmarks appear at the top of the tree and let you switch roots instantly.
Mermaid
Diagrams in the terminal.
Render Mermaid blocks inline, open as HTML, or push to a temporary share link that auto-expires after the first view.
Shell integration
Exit into a directory.
Press Shift+G to cd into the selected folder when you quit. Your shell session lands exactly where you left off.
Install
Windows
irm https://raw.githubusercontent.com/csr91/mdnav/master/install.ps1 | iex
Linux / macOS
curl -fsSL https://raw.githubusercontent.com/csr91/mdnav/master/install.sh | bash