Uninstalling Skaro

Uninstall steps

The process depends on how you originally installed Skaro.

Install script (venv)
pipx

The install script creates a virtual environment and a shim in ~/.skaro/. Removing these two directories is enough.

Stop running processes

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

pkill -f skaro || true

Remove the venv and CLI shim

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

rm -rf ~/.skaro/venv ~/.local/bin/skaro

(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 the line that adds ~/.skaro/bin to PATH
# from your shell profile (~/.bashrc, ~/.zshrc, etc.)

Uninstall the package

pipx uninstall skaro

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"

rm -rf ~/.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.

Getting Started

CLI Reference

Web Dashboard

LLM Providers

Skills

Customization

Project Structure

Settings

Guides

Uninstalling Skaro

Uninstall steps

Remove project data

Remove global config

Verify

​Uninstall steps

​Remove project data

​Remove global config

​Verify

Uninstall steps

Remove project data

Remove global config

Verify