Skip to content

About

No description, website, or topics provided.

Resources

Code of conduct

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

CLI Manager icon

CLI Manager

A native macOS menu bar app that discovers, organizes, and manages all your CLI tools in one place.

Release License Platform Swift


Developers accumulate dozens of CLI tools over time — installed via Homebrew, npm, pip, cargo, and more. CLI Manager sits in your menu bar and gives you a unified view of every tool on your system: what's installed, where it came from, which version you're running, and whether an update is available.

Features

  • Auto-discovery — Scans 13+ package managers and your $PATH to find every CLI tool on your system
  • One-click updates — Update tools directly from the app (Homebrew, npm, pnpm, yarn, bun, pip, cargo)
  • Uninstall support — Remove tools you no longer need, with safety warnings for high-impact operations
  • Smart categorization — Tools are automatically grouped into categories like Cloud, DevOps, Security, AI, and more
  • Tool families — Related binaries (e.g. PostgreSQL's 38+ commands) are collapsed into a single entry
  • Favorites — Pin your most-used tools for quick access
  • Search — Full-text search across names, categories, and display names
  • Update badge — See at a glance how many tools have updates available
  • Live progress — Real-time scan progress with ETA and streaming update output
  • Conflict detection — Spots the same CLI installed from multiple sources

Supported Package Managers

Manager Detect Update Uninstall
Homebrew (formulas & casks) Yes Yes Yes
npm Yes Yes Yes
pnpm Yes Yes Yes
yarn Yes Yes Yes
Bun Yes Yes Yes
pip Yes Yes Yes
Cargo Yes Yes Yes
Go Yes — —
asdf Yes — —
mise Yes — —
nvm Yes — —
Volta Yes — —
Standalone ($PATH) Yes — —

Installation

Download

Download the latest .dmg from the Releases page, open it, and drag CLI Manager to your Applications folder.

Build from Source

Requires macOS 14 (Sonoma) or later and Swift 6.3+.

# Clone the repository
git clone https://github.com/huynextlevel/CLIManager.git
cd CLIManager

# Build and run
./scripts/build-app.sh --run

To create a distributable .dmg:

./scripts/build-dmg.sh

The DMG will be created in the project root as CLIManager-<version>.dmg.

Usage

  1. Launch — CLI Manager appears as an icon in your menu bar
  2. Scan — On first launch, it automatically scans your system (subsequent scans run every hour or on demand)
  3. Browse — View all your tools in a searchable, categorized list
  4. Act — Click any tool to see details, check for updates, open docs, or uninstall

Architecture

CLI Manager is built with:

  • Swift 6.3 with strict concurrency
  • SwiftUI using MenuBarExtra and @Observable
  • Swift Package Manager for builds
  • No third-party dependencies

For a deep dive into the architecture, see cli-manager-architecture.md.

Contributing

Contributions are welcome! Please read the Contributing Guide before submitting a pull request.

License

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

About

No description, website, or topics provided.

Resources

Code of conduct

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages