NGM - Node Global Packages Manager

A modern TUI-based Node.js global packages manager that works across multiple Node version managers (fnm, nvm, n, and local installations).

✨ Features

• 🎯 Multi-Manager Support: Works seamlessly with fnm, nvm, n, and local Node installations
• 🎨 Beautiful TUI: Modern terminal UI with mouse support, keyboard navigation, and intuitive focus management
• 📦 Package Management: List, update, uninstall global npm packages across different Node versions
• 🔄 Automatic Refresh: Packages list automatically refreshes after updates/uninstalls
• 🌍 Internationalization: Built-in support for English and Chinese (auto-detects system locale)
• 🖱️ Mouse Support: Click to switch focus panels, scroll with mouse wheel
• 📊 Outdated Detection: Shows which packages need updates with version comparison
• ⚡ Fast Search: Filter packages and Node versions instantly
• 🎭 IME Friendly: Handles Chinese input methods properly without interruption

🚀 Quick Start

Installation

🚀 Quick Install (Recommended)

curl -fsSL https://raw.githubusercontent.com/Way-To-AGI/ngm/main/install.sh | bash

📦 Download Binary

Download the appropriate binary for your system from the Releases page:

Linux/macOS:

# Download and extract (example for Linux AMD64)
curl -L https://github.com/Way-To-AGI/ngm/releases/latest/download/ngm-linux-amd64.tar.gz | tar xz
sudo mv ngm /usr/local/bin/

Windows:

# Download and extract
Invoke-WebRequest -Uri "https://github.com/Way-To-AGI/ngm/releases/latest/download/ngm-windows-amd64.exe.zip" -OutFile "ngm.zip"
Expand-Archive -Path "ngm.zip" -DestinationPath "."

From Source

git clone https://github.com/Way-To-AGI/ngm.git
cd ngm
go build -o ngm ./cmd/ngm
sudo mv ngm /usr/local/bin/  # or add to your PATH

Requirements

• Go 1.22 or later
• Node.js with npm
• One of the following Node version managers (optional):
  • fnm
  • nvm
  • n

Basic Usage

Launch TUI

ngm
# or with specific language
ngm --lang zh-CN  # Chinese
ngm --lang en     # English

CLI Commands

# List detected Node version managers and versions
ngm versions

# List global packages for current Node
ngm list

# List outdated packages
ngm outdated

# Update packages
ngm update package1 package2

# Uninstall packages
ngm uninstall package1

# Export/Import package lists
ngm export > packages.txt
ngm import < packages.txt

🎮 TUI Controls

Navigation

• ←/→ or h/l: Switch focus between panels (Nodes/Packages/Outdated)
• Tab: Cycle focus forward (Nodes → Packages → Outdated → Nodes)
• Shift+Tab: Cycle focus backward
• Mouse Click: Click on any panel to focus it
• Mouse Wheel: Scroll within focused panel

Actions

• Space: Select/deselect current package
• a: Select/deselect all visible packages
• u: Update selected packages
• d: Uninstall selected packages (only in Packages panel)
• r: Refresh package lists
• /: Search/filter current list
• Enter: Switch Node version (in Nodes panel)
• q: Quit

📖 Screenshots

Main Interface

⬡ ngm  [nvm v20.18.1]

┌─────────────────────┬──────────────────────────────┬──────────────────────────────┐
│ ▸ nvm              │ ● Packages                  │ ● Outdated                   │
│    ● v20.18.1      │ [ ] @anthropic-ai/claude-code│ [ ] @anthropic-ai/claude-code│
│    v22.15.0        │ [ ] npm                      │   2.0.76 -> 2.0.77           │
│    v22.11.0        │ [ ] typescript               │ [ ] npm                       │
│    v18.20.5        │ [ ] yarn                     │   10.9.0 -> 10.9.1           │
│    v16.20.2        │ [x] eslint                  │ [ ] yarn                      │
│    v14.21.3        │ [x] prettier                 │   1.22.22 -> 1.22.23         │
│    v10.24.1        │ [ ] webpack                  │                              │
└─────────────────────┴──────────────────────────────┴──────────────────────────────┘

┌─────────────────────────────────────┬──────────────────────────────┐
│ ● Logs                              │ ● Details                     │
│ update: done                        │ @anthropic-ai/claude-code     │
│ loaded 32 packages                  │                               │
│ loaded 6 outdated                    │ Current: 2.0.76               │
│                                    │ Latest: 2.0.77                │
└─────────────────────────────────────┴──────────────────────────────┘

←/→ or h/l switch panel  tab cycle  / search  space select  a all  u update  d uninstall  r refresh  q quit

🔧 Configuration

NGM can be configured via ~/.config/ngm/config.yaml:

lang: auto                    # auto, zh-CN, en
max_concurrent_tasks: 3       # Max concurrent update/uninstall tasks
cache_ttl_seconds: 600        # Cache duration
cache_dir: ""                 # Custom cache directory (default: ~/.cache/ngm)

Environment Variables

• NGM_LANG: Override language detection
• NVM_DIR: nvm directory (default: ~/.nvm)

🌍 Internationalization

NGM supports multiple languages and automatically detects your system locale:

• English (default)
• Chinese (Simplified) - Auto-detected on macOS/Linux systems

You can override the language:

ngm --lang zh-CN  # Force Chinese
ngm --lang en     # Force English
export NGM_LANG=zh-CN  # Environment variable

🏗️ Architecture

ngm/
├── cmd/ngm/           # CLI entry point
├── internal/
│   ├── cli/           # CLI commands
│   ├── tui/           # Terminal UI
│   ├── npm/           # npm client
│   ├── runners/       # Node version managers (fnm, nvm, n, local)
│   ├── i18n/          # Internationalization
│   ├── config/        # Configuration management
│   ├── cache/         # Caching layer
│   └── task/          # Task scheduler
└── docs/              # Documentation

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Development Setup

git clone https://github.com/Way-To-AGI/ngm.git
cd ngm
go mod tidy
go build -o ngm ./cmd/ngm
./ngm

Running Tests

go test ./...

Code Style

• Follow Go conventions
• Use meaningful variable names
• Add comments for public functions
• Keep functions small and focused

📝 Roadmap

• Package version locking
• Bulk operations with progress bars
• Package dependency visualization
• Configuration GUI
• Plugin system for custom runners
• Package installation from specific registries
• Global package audit and security scanning

🐛 Troubleshooting

Common Issues

"No Node versions found"

• Ensure your Node version manager is installed and in PATH
• For nvm, check that ~/.nvm/nvm.sh exists
• Try running ngm versions to debug detection

"Permission denied"

• Make sure ngm has permission to access npm global directories
• On some systems, you may need to run with sudo for certain operations

Chinese input issues

• NGM handles IME input automatically
• If issues persist, try switching to English input mode

Debug Mode

Set environment variable for debug output:

NGM_DEBUG=1 ngm

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Bubble Tea - Amazing TUI framework
• Lip Gloss - Style definitions
• Cobra - CLI framework
• Node.js community for the excellent package managers

📞 Support

• 🐛 Report Bugs
• 💡 Feature Requests
• 💬 Discussions

---

Made with ❤️ by Way-To-AGI

If you find this tool helpful, please give it a ⭐ on GitHub!