> ## Documentation Index
> Fetch the complete documentation index at: https://extension.js.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Uninstall command to remove managed browsers

> Remove managed browser runtimes from the Extension.js cache. Only affects browsers installed by Extension.js, not your system browsers.

Use `uninstall` to remove managed browser runtimes from the Extension.js cache.

This only removes browsers that Extension.js installed in its managed cache root. It does not touch system Chrome, system Edge, or any browser installed outside that cache.

## When to use `uninstall`

* You want to reclaim disk space from managed browsers you no longer need.
* You are resetting a managed browser install to force a fresh download on next `install`.
* You are cleaning up continuous integration (CI) caches or switching browser targets.

## Canonical usage

For a single browser, use the positional form:

<CodeGroup>
  ```bash npm theme={null}
  extension uninstall <browser>
  ```

  ```bash pnpm theme={null}
  extension uninstall <browser>
  ```

  ```bash yarn theme={null}
  extension uninstall <browser>
  ```

  ```bash bun theme={null}
  extension uninstall <browser>
  ```

  ```bash deno theme={null}
  extension uninstall <browser>
  ```
</CodeGroup>

Use `--all` to remove every managed browser target.

## Usage

<CodeGroup>
  ```bash npm theme={null}
  extension uninstall [browser-name] [options]
  ```

  ```bash pnpm theme={null}
  extension uninstall [browser-name] [options]
  ```

  ```bash yarn theme={null}
  extension uninstall [browser-name] [options]
  ```

  ```bash bun theme={null}
  extension uninstall [browser-name] [options]
  ```

  ```bash deno theme={null}
  extension uninstall [browser-name] [options]
  ```
</CodeGroup>

## Arguments and flags

| Flag / argument       | What it does                                                                       | Default  |
| --------------------- | ---------------------------------------------------------------------------------- | -------- |
| `[browser-name]`      | Remove a single managed browser such as `chrome`, `chromium`, `edge`, or `firefox` | unset    |
| `--browser <browser>` | Explicit flag form of the browser argument                                         | unset    |
| `--all`               | Remove all managed browser runtimes from the Extension.js cache                    | disabled |
| `--where`             | Print the resolved cache root, or browser-specific managed paths                   | disabled |

## Examples

### Remove managed Chrome for Testing

```bash theme={null}
extension uninstall chrome
```

### Remove all managed browsers

```bash theme={null}
extension uninstall --all
```

### Show the managed uninstall path for Firefox

```bash theme={null}
extension uninstall firefox --where
```

## Best practices

* **Use `--all` in CI teardown** to clean up managed browsers after test runs.
* **Use `--where` first** to confirm what will be removed before scripting bulk uninstalls.
* `uninstall` is safe for system browsers; it only removes Extension.js-managed cache folders.

## Behavior notes

* If you set `EXT_BROWSERS_CACHE_DIR`, uninstall uses that custom cache root.

## Next steps

* Reinstall managed browsers with [`install`](/docs/commands/install).
* Review browser targeting with [`dev`](/docs/commands/dev) and [`start`](/docs/commands/start).
* Learn about [Running other browsers](/docs/browsers/running-other-browsers) with custom binary paths.