Muse Code Uninstaller

# 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 `muse` launcher
- 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/muse` or `~/.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:

```bash
git clone <your-repository-url>
cd muse-code-uninstaller
chmod +x uninstall-muse.sh
```

### Preview only

Run without arguments:

```bash
./uninstall-muse.sh
```

Example:

```text
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:

```bash
./uninstall-muse.sh --uninstall
```

The script removes only the Muse-related paths it discovered during that run.

### Help

```bash
./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.