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

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.

Controls:

• Use Up/Down arrow keys to move through the list.
• Use Left/Right arrow keys to expand or collapse folders.
• Press ~ (Tilde) to instantly jump back to your Home directory.
• Use the Mouse to click items and expand folders.
• Press Enter to instantly exit the UI and change your terminal's working directory to the selected folder.
• Press q, Q, Escape, or click outside the list to exit cleanly without changing directories.