---
summary: "CLI reference for SKYKOI uninstall (stop the service, remove the CLI, optionally delete data)"
read_when:
  - You want to remove SkyKoi from this machine
  - You want to also delete your config, credentials and memory database
  - You want a dry-run first
title: "uninstall"
---

# `SKYKOI uninstall`

Remove SkyKoi from this machine. It stops the gateway service, removes the `skykoi`
CLI the way it was installed (npm, pnpm or bun), and optionally deletes your data.
Works on macOS, Linux and Windows.

Interactive by default: it asks for a single confirmation, then asks whether you
also want to remove your data.

```bash
# Interactive: confirm, then choose whether to delete data
SKYKOI uninstall

# Uninstall but keep data (config, credentials, memory database, workspaces)
SKYKOI uninstall --yes

# Full removal, no prompts
SKYKOI uninstall --yes --remove-data

# Preview the actions without changing anything
SKYKOI uninstall --dry-run
```

## Options

- `--remove-data`: also delete `~/.skykoi` (config, credentials, memory database) and workspaces
- `--keep-data`: keep all data; only remove the service and CLI
- `--keep-cli`: do not uninstall the `skykoi` npm package
- `--yes`: skip the confirmation prompts
- `--non-interactive`: disable prompts (requires `--yes`)
- `--dry-run`: print the actions without removing anything

The gateway service is stopped before any data is deleted, so the memory database
and workspace files are released first (this is what lets the folder be removed on
Windows). The CLI package is uninstalled after the process exits, because a running
koi holds a lock on its own files.