№ 0841GitHub
Muse Code Uninstaller
An unofficial uninstall utility that finds Muse Code binaries and state files, estimates reclaimable space in a dry run and deletes them only with --uninstall.
Muse Code Uninstaller
A small, transparent uninstall utility for Muse Code.
By default, it performs a dry run: it finds Muse Code files on your machine and estimates how much storage space can be reclaimed. Nothing is deleted unless you explicitly pass --uninstall.
This is an unofficial community project and is not affiliated with, endorsed by, or maintained by Meta.
Why this exists
Muse Code's muse command is a shell launcher. The launcher can download and manage versioned Muse binaries and local state files alongside itself, so deleting only the muse launcher may leave additional files behind.
This utility collects those known files, shows you what it found, estimates their disk usage, and can remove them in one command.
What it removes
The script looks for:
- the
muselauncher - versioned
muse-bin-*executables - Muse launcher/update state such as
.muse-version,.muse-release-info.json, and update metadata - Muse's default configuration directory at
$XDG_CONFIG_HOME/museor~/.config/muse - a custom
MUSE_AUTH_PATH, when one is set outside the normal Muse config directory
It does not remove the parent ~/.local/bin directory or unrelated files in it.
Usage
Clone the repository and make the script executable:
git clone <your-repository-url>
cd muse-code-uninstaller
chmod +x uninstall-muse.sh
Preview only
Run without arguments:
./uninstall-muse.sh
Example:
Muse Code files found:
12.00 KB /Users/you/.local/bin/muse
182.40 MB /Users/you/.local/bin/muse-bin-1.2.3-R4
8.00 KB /Users/you/.config/muse
Estimated space recoverable: 182.42 MB
Nothing was deleted.
To uninstall:
./uninstall-muse.sh --uninstall
Uninstall
When you're ready:
./uninstall-muse.sh --uninstall
The script removes only the Muse-related paths it discovered during that run.
Help
./uninstall-muse.sh --help
Safety model
The default behavior is intentionally read-only. You must explicitly provide --uninstall before the script removes anything.
Before deletion, the script prints every path it plans to remove and estimates the amount of storage that can be reclaimed.
If you use Muse-specific environment variables such as XDG_CONFIG_HOME or MUSE_AUTH_PATH, run the script from the same environment so it can locate those files correctly.
