What is SnapPoint?

SnapPoint is an essential, open-source utility engineered to restore order and performance to your development machine. Over time, systems accumulate digital debris—unclaimed binaries, conflicting software versions, and outdated caches—often left behind by various package managers, quick installs, and experimental setups. SnapPoint acts as an interactive system auditor, meticulously scanning your environment to identify these hidden issues, ensuring your $PATH is clean and your global binaries are accounted for.

Built with developers in mind, SnapPoint provides unparalleled visibility into what is truly installed on your macOS or Linux system. By detecting 'ghost binaries' (executables not claimed by any known manager), resolving version conflicts (like multiple Node installations fighting for precedence), and flagging orphaned packages, SnapPoint helps maintain a conflict-free, high-performance development workflow. It empowers users to take back control of their system's integrity with simple, powerful commands.

Key Features

SnapPoint offers a robust suite of tools designed for deep system hygiene:

• Ghost Binary Detection: Identifies binaries located in directories like /usr/local/bin that are not tracked or claimed by any recognized package manager (e.g., Homebrew, apt, pip).
• PATH Conflict Resolution: Scans and reports when multiple versions of the same tool (like different Node.js versions) are vying for execution priority in your system's $PATH variable.
• Orphaned Package Cleanup: Locates and flags dependencies or related files that remain on the system long after the primary parent application has been removed.
• Cache Bloat Identification: Helps users find and reclaim disk space lost to caches generated by tools that are no longer in use.
• Comprehensive Scanning: Provides a detailed, readable report (snappoint list) showing the name, path, managing tool, and version for every global binary found.
• No Sudo Required: Operates safely without requiring elevated administrative privileges for scanning and detection tasks.
• Built with Go: Delivered as a single, self-contained binary for easy installation and execution.

How to Use SnapPoint

Getting started with SnapPoint is designed to be fast and dependency-free. The recommended installation method involves a single curl command:

$ curl -sS https://snappoint.dev/install.sh | sh

Once installed, the workflow revolves around three core commands:

1. Check Health (snappoint doctor): Run this first to see which package managers SnapPoint has detected on your system and get an initial overview of potential issues.
2. Scan System (snappoint scan): This command performs the deep audit, analyzing all global binaries and mapping their origins.
3. View Results (snappoint list): Review the detailed output, which clearly highlights conflicts, ghost binaries, and orphaned components, allowing you to decide which items to safely purge or realign.

For advanced users, building from source is also an option, leveraging its Go implementation.

Use Cases

SnapPoint is invaluable for several developer scenarios:

1. Onboarding New Developers: Quickly audit a fresh development machine to ensure no legacy conflicts or hidden binaries from previous projects interfere with new setups.
2. Resolving Mysterious Errors: When a command behaves unexpectedly (e.g., running an old version of a tool), SnapPoint can instantly pinpoint the conflicting binary location in the $PATH.
3. System Migration/Cleanup: Before migrating to a new OS version or performing a major system overhaul, SnapPoint ensures you only back up or migrate essential, managed software, leaving behind years of cruft.
4. Managing Multi-Version Environments: Developers who frequently switch between different versions of interpreters (like Python or Node) using tools like nvm or pyenv can use SnapPoint to ensure only the intended version is active globally.
5. Security Auditing: Identifying unknown or 'ghost' binaries running with global permissions can be a crucial step in hardening a development workstation against potential security risks.

FAQ

Q: Is SnapPoint free to use? A: Yes, SnapPoint is completely open-source and free to use under the MIT License. It is built by developers for the community.

Q: Which operating systems does SnapPoint support? A: SnapPoint currently supports macOS and Linux distributions. It is built in Go, making cross-platform compilation straightforward.

Q: Do I need administrator (sudo) rights to run SnapPoint? A: No. SnapPoint is designed to scan and report issues without requiring sudo. Actions involving deletion or modification would require user confirmation and potentially elevated rights, but the initial audit is safe and non-intrusive.

Q: How does SnapPoint know which package manager owns a binary? A: SnapPoint maintains a database of known package manager installation directories and tracking files. When it finds a binary, it checks these known locations to attribute ownership. Binaries found outside these managed paths are flagged as 'ghosts'.

Q: Can SnapPoint automatically fix all conflicts? A: SnapPoint excels at detection and reporting. While it provides the necessary information to resolve issues, it prioritizes showing you exactly what is happening before making destructive changes, ensuring you maintain ultimate control over your system alignment.