v1.3.1 โ€” built for Windows PowerShell

Navigate your terminal.
with intention.

A zero-dependency directory navigator for PowerShell. Mouse-aware, instant search, and motion that responds the moment you do.

Install TermNav View source
PowerShell 7 โ€” termnav
/
Capabilities

Made to feel direct.

Every interaction responds on contact, tracks 1:1, and never makes you wait for an animation to finish.

Mouse, on the command line.

Click to expand. Click again to collapse. Scroll through long directories with zero friction. The interface was designed for a pointer first, keyboard second.

๐Ÿ“ src/
๐Ÿ“ components/
๐Ÿ“„ index.js
๐Ÿ“„ app.js

Instant search.

Press / and the entire tree filters as you type. No indexing, no delays, no surprises.

๐Ÿ“„ index.js
๐Ÿ“„ tui.js
๐Ÿ“„ input.js
๐Ÿ“„ package.json

Zero dependencies.

Pure Node.js standard library. No npm tree, no supply chain. Just one binary that does the job.

npm ls โ†’ (empty)

Smart viewport.

Renders only what your terminal can show. Even the biggest node_modules scrolls like butter.

๐Ÿ“ .
โ”œโ”€โ”€ ๐Ÿ“ src/
โ”œโ”€โ”€ ๐Ÿ“ docs/
โ”œโ”€โ”€ ๐Ÿ“ tests/
โ”œโ”€โ”€ ๐Ÿ“ node_modules/
โ”œโ”€โ”€ ๐Ÿ“„ package.json
โ””โ”€โ”€ ๐Ÿ“„ README.md

Windows native.

Purpose-built for PowerShell. No WSL, no emulation, no compromises.

$_

Select, exit, change directory.

Press Enter and your shell cd's into the folder. The PowerShell wrapper wires it up automatically โ€” no profile edits.

โ†’ Set-Location 'C:\Users\Harsha\project\src'
PS C:\Users\Harsha\project\src> _

Silent auto-updates.

A detached background process checks the registry once per day. You'll see a one-line notice only when something's new โ€” never a blocking modal.

$ tn --internal-update-check
โ†ป termnav 1.3.0 available โ€” run npm i -g @harshakatta/termnav
Install

One command. Ten seconds.

Installs globally, drops a tn.ps1 wrapper, done.

# Requires Node.js 16+ on Windows
$ npm install -g @harshakatta/termnav

# Then anywhere:
$ tn
1

Run the install command above. postinstall creates a tn.ps1 wrapper in your npm prefix โ€” no profile edits needed.

2

Open a new PowerShell window and type tn. The navigator drops you into your current directory, ready to browse.

3

Use the arrow keys, type / to search, or click. Press Enter to change to the selected folder.

Controls

Keyboard, mouse, or both.

Designed for parallel input. Every gesture is detected from the first move, then routed with confidence.

๐Ÿงญ Navigation

Move selectionโ†‘โ†“
Expand folderโ†’
Collapse folderโ†
Open / selectEnter
Jump to home~
Quit (no cd)q Esc

๐Ÿ” Search

Enter search mode/
Filter by nametype any part
Open resultEnter
Exit (restore view)Esc

Get started in 10 seconds.

One npm install. Zero dependencies. Pure terminal velocity.

Install TermNav