Skip to main content

Uninstall steps

The process depends on how you originally installed Skaro.
The install script creates a virtual environment and a shim in ~/.skaro/. Removing these two directories is enough.
1

Stop running processes

Get-Process -Name skaro, python -ErrorAction SilentlyContinue | Stop-Process -Force
2

Remove the venv and CLI shim

Remove-Item -Recurse -Force "$env:USERPROFILE\.skaro\venv", "$env:USERPROFILE\.skaro\bin"
3

(Optional) Remove the PATH entry

The installer added ~/.skaro/bin to your user PATH. You can remove it manually:
$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')

Remove project data

Skaro stores per-project data in a .skaro/ directory inside each project where you ran skaro init. To clean up:
# From the project root
rm -rf .skaro
On Windows:
Remove-Item -Recurse -Force .skaro
This permanently deletes all Skaro artifacts for the project — constitution, architecture, dev plan, task history, and token usage logs.

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:
Remove-Item -Recurse -Force "$env:USERPROFILE\.skaro"

Verify

Confirm that Skaro is no longer accessible:
skaro --version
You should see a “command not found” error. If the command still resolves, restart your terminal so that PATH changes take effect.