TermNav

TermNav is a blazing fast, zero-dependency interactive terminal directory navigator for Windows PowerShell.

It provides a sleek, minimalist interactive UI with mouse support and a nested folder tree to seamlessly traverse directories directly from your terminal.

Features

• Pro-Coder Aesthetic: Clean, minimalist UI with strict Unicode geometry, subtle cyan accents, and a persistent status bar.
• Instant Start: "Install and go" philosophy. Drops directly into your global npm path for immediate execution without needing PowerShell profile modifications or terminal restarts.
• Smart Viewport Scrolling: Effortlessly handles massive directories (like node_modules or root drives) by dynamically limiting rendering to your terminal's visible height.
• Robust Error Handling: Safely handles permission-denied folders without crashing the UI.
• Zero-Latency Auto-Updates: Runs a silent, detached background process to check for updates, keeping startup times strictly at 0ms.
• Full Mouse Support: Navigate, expand, collapse, and select directories using just your mouse. Built with SGR mouse mode to support ultra-wide terminals.

Installation

Install the package globally via npm:

npm install -g @harshakatta/termnav

Releases are published from GitHub Actions and require an npm automation token stored in the repository secret named NODE_AUTH_TOKEN.

Note: TermNav is currently designed exclusively for Windows PowerShell. Non-Windows systems are not supported.

That's it! The installer automatically configures the tn command. You can start using it instantly.

Usage

Simply type tn in your terminal to launch the navigator.

You can also start in a specific directory:

tn C:\code\myapp

Options:

• tn [directory] — Start in the specified directory
• tn --version or tn -v — Show version number
• tn --help or tn -h — Show help message

Controls:

• Use Up/Down arrow keys to move through the list.
• Use Left/Right arrow keys to expand or collapse folders.
• Press / to open fast file search, type to filter, then use Enter to open a directory.
• Press ~ (Tilde) to instantly jump back to your Home directory.
• Press Ctrl+R to refresh the current directory (clears stale cache).
• Use the Mouse to click items and expand folders. Click outside the list to quit.
• Press Enter to open a directory or select a file path.
• Press q, Q, or Escape to exit cleanly without changing directories.