orb-manager

A terminal UI (TUI) npm package manager built with Ink (React for CLI). Browse, install, and manage npm packages directly from your terminal with an interactive interface.

Install

npm i orb-manager
npx orb

Or build from source:

npm install --legacy-peer-deps
npm run build
npx orb

Screenshots

Features

orb provides four main panes for package management:

Search

• Search the npm registry for packages
• View package details (version, description, keywords, publisher, links)
• Install packages locally (i) or globally (g)
• Paginated results with n for next page

Dependency Graph

• Visualize the complete dependency tree from npm ls --json
• Expand/collapse dependency nodes
• Remove packages directly (r)
• Navigate with arrow keys

Issues

Multi-scanner for detecting project issues:

• Dependencies: Missing deps, invalid packages, peer missing deps
• Vulnerabilities: Security advisories (via npm audit)
• Outdated: Outdated packages (via npm outdated)
• Linting: Code & lint issues (via Biome linter)
• Unused: Unused dependencies (via Knip)
• Uninstall unused dependencies with u

Settings

Configure npm install behavior:

• --legacy-peer-deps flag
• --save-exact flag
• --prefer-offline flag

Keyboard Shortcuts

| Key | Action | | ----------- | ---------------------------------- | | Tab | Switch between panes | | Escape | Reset current view / clear search | | ↑ ↓ | Navigate list | | → Enter | View package details | | ← | Back to list | | i | Install package locally | | g | Install package globally | | n | Next page (in search) | | r | Refresh / rescan | | u | Uninstall (in unused dependencies) | | t | Toggle setting (in settings) |

Tech Stack

• UI Framework: Ink - React for CLI
• Linter: Biome
• Unused Dependency Checker: Knip
• Language: TypeScript

License

MIT