npm-tui

README

npm-tui

A minimal, keyboard-first TUI for npm built with Bubble Tea. Search, inspect, install/update your project's npm packages, and view package READMEs — all without leaving your terminal.

Quick keys

Context	Key	Action
Input	Enter	Run search for current query
Results	↑/↓	Move selection
Results	Enter	Toggle details sidebar for selected package
Results (sidebar open)	r	View README for selected package
Results	i	Install selected package
Results	I	Install as dev dependency
Results	u	Update selected package to latest (if installed)
Anywhere	Tab	Toggle focus between sections
Anywhere	Esc	Clear input and show your project packages
Anywhere	Ctrl+C	Quit

Tip: The help footer updates based on what you can do at the moment.

Features

• 🔎 Fast npm search from the terminal
• 🧰 Manage and update your project's npm packages
• 📊 Results show version, weekly downloads, license, and author
• 📚 Details sidebar with description and quick links (homepage, repo, npm)
• ⌨️ One-key install (i), dev install (I), and update (u) when installed
• 🧠 Auto-detects npm, pnpm, yarn, and bun via lockfiles
• 🧩 Responsive layout with a toggleable sidebar
• 📖 In-app README viewer for packages with a GitHub repo

Install

Install with Go:

go install github.com/fredrikmwold/npm-tui/cmd/npm-tui@latest

Or download a prebuilt binary from the Releases page and place it on your PATH:

• https://github.com/FredrikMWold/npm-tui/releases