fix_globals 1.1.0

A command-line utility to cleanly reinstall and refresh all globally activated Dart and Flutter packages from their original sources (pub, path, git, and custom registries).

fix_globals

A robust, lightweight command-line utility to cleanly reinstall and refresh all globally activated Dart and Flutter packages from their original sources (pub.dev, local paths, git repositories, and custom hosted registries).

This utility parses your current globally activated packages, deactivates them, and reactivates them using their original settings—perfect for when a Dart SDK upgrade breaks global links, when switching Dart tool managers (such as Puro), or when you just want to refresh all your active global tools.

---

Features

• Multi-Source Support: Seamlessly detects and re-installs packages from:
  • 🌐 pub.dev (standard hosted packages)
  • 📂 Local path (at path)
  • 🐙 Git repositories (including custom references/branches and sub-paths)
  • 🏠 Custom registries (at hosted custom servers)
• Safe Dry-Run Mode: See exactly what actions will be taken without modifying any packages on disk using --dry-run (-n).
• Flexible SDK Targets: Choose whether to run the reactivation processes using dart or flutter globally with --sdk (-s).
• Update Mode (Cron Friendly): Pull new package versions without clean-slating or deactivating them first using --update (-u).
• Robust Execution: Runs sequentially and logs all success/failure status clearly.

---

Installation

Activate fix_globals globally via the Dart SDK:

dart pub global activate fix_globals

---

Usage

Run the utility:

fix-globals [options]

Options

Option	Alias	Description
--dry-run	-n	Show the activation commands that would be executed without running them.
--sdk	-s	The SDK executable to use for activation (dart or flutter). [default: dart]
--update	-u	Skip deactivating packages. Useful in a daily cron job to quickly pull and bind the latest versions of your packages without the expense of a full reinstall/recompile of same-version packages.
--help	-h	Print this usage help menu.

---

Default Mode vs. Update Mode

• Default Mode (no extra flags): Clears out the existing activation state using deactivate first, then completely downloads/re-clones and recompiles each package. This is required when upgrading your Dart/Flutter SDK to guarantee that every package's precompiled binaries are rebuilt for compatibility with the new SDK.
• Update Mode (--update / -u): Bypasses the deactivate step. It behaves like a standard pub global activate --overwrite command. It runs extremely fast for packages already at the latest version, while still fetching and compiling any newly released versions or local path/git packages that have new changes. Perfect for a regular scheduler or daily cron job.

---

Example

$ fix-globals --dry-run
[info] Parsing globally activated packages...
[info] Found 3 activated packages.
[info] [Dry-Run] Would deactivate dcm
[info] [Dry-Run] Would activate dcm at path "/Users/username/Projects/dcm"
[info] [Dry-Run] Would deactivate melos
[info] [Dry-Run] Would activate melos from git "https://github.com/invertase/melos.git"
[info] [Dry-Run] Would deactivate sass
[info] [Dry-Run] Would activate sass from pub.dev
[info] Dry-run complete. No changes were made.

License

This project is licensed under the BSD 3-Clause License - see the LICENSE file for details.