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.

✓ Windows✓ Linux✓ macOS

You're already in the terminal. Why open Explorer or Finder?

~/projects/myappREADME.md
▸ src/
▸ docs/
README.md
package.json
tsconfig.json
# myapp
A full-stack web application
built with Next.js and TypeScript.
## Getting started
npm install
npm run dev
hjklTabShift+M:git:q

⌨

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.


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