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

# Uninstalling Skaro

> How to completely remove Skaro from your system.

## Uninstall steps

The process depends on how you originally installed Skaro.

<Tabs>
  <Tab title="Install script (venv)">
    The install script creates a virtual environment and a shim in `~/.skaro/`. Removing these two directories is enough.

    <Steps>
      <Step title="Stop running processes">
        <CodeGroup>
          ```powershell Windows theme={null}
          Get-Process -Name skaro, python -ErrorAction SilentlyContinue | Stop-Process -Force
          ```

          ```bash macOS / Linux theme={null}
          pkill -f skaro || true
          ```
        </CodeGroup>
      </Step>

      <Step title="Remove the venv and CLI shim">
        <CodeGroup>
          ```powershell Windows theme={null}
          Remove-Item -Recurse -Force "$env:USERPROFILE\.skaro\venv", "$env:USERPROFILE\.skaro\bin"
          ```

          ```bash macOS / Linux theme={null}
          rm -rf ~/.skaro/venv ~/.local/bin/skaro
          ```
        </CodeGroup>
      </Step>

      <Step title="(Optional) Remove the PATH entry">
        The installer added `~/.skaro/bin` to your user PATH. You can remove it manually:

        <CodeGroup>
          ```powershell Windows theme={null}
          $binDir = Join-Path $env:USERPROFILE '.skaro\bin'
          $userPath = [Environment]::GetEnvironmentVariable('Path', 'User')
          $newPath = ($userPath -split ';' | Where-Object { $_ -ne $binDir }) -join ';'
          [Environment]::SetEnvironmentVariable('Path', $newPath, 'User')
          ```

          ```bash macOS / Linux theme={null}
          # Remove the line that adds ~/.skaro/bin to PATH
          # from your shell profile (~/.bashrc, ~/.zshrc, etc.)
          ```
        </CodeGroup>
      </Step>
    </Steps>
  </Tab>

  <Tab title="pipx">
    <Steps>
      <Step title="Uninstall the package">
        ```bash theme={null}
        pipx uninstall skaro
        ```
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Remove project data

Skaro stores per-project data in a `.skaro/` directory inside each project where you ran `skaro init`. To clean up:

```bash theme={null}
# From the project root
rm -rf .skaro
```

On Windows:

```powershell theme={null}
Remove-Item -Recurse -Force .skaro
```

<Warning>
  This permanently deletes all Skaro artifacts for the project — constitution, architecture, dev plan, task history, and token usage logs.
</Warning>

## Remove global config

Skaro may store a cached update check and global settings in `~/.skaro/`. If you want a full cleanup and no longer need any Skaro data:

<CodeGroup>
  ```powershell Windows theme={null}
  Remove-Item -Recurse -Force "$env:USERPROFILE\.skaro"
  ```

  ```bash macOS / Linux theme={null}
  rm -rf ~/.skaro
  ```
</CodeGroup>

## Verify

Confirm that Skaro is no longer accessible:

```bash theme={null}
skaro --version
```

You should see a "command not found" error. If the command still resolves, restart your terminal so that PATH changes take effect.