> For the complete documentation index, see [llms.txt](https://kerno.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kerno.gitbook.io/docs/getting-started/uninstall-kerno.md).

# Uninstall Kerno

### Uninstall with your agent

Paste this into the coding agent Kerno is connected to.

```
Uninstall Kerno from this machine. Show me each change before you make it.

Remove the kerno entry from my coding tool's MCP config, and the allowlist rule that went with it:
"mcp__kerno__*" in permissions.allow for Claude Code, or the
[plugins."kerno@kerno".mcp_servers.kerno] block for Codex. Ask me which host if it isn't obvious.

  kerno uninstall              stops the agent and removes the downloaded runtime
  npm uninstall -g @kerno/cli

If the kerno plugin is installed, remove it too: /plugin uninstall kerno@kerno in Claude Code, or the
equivalent in Cursor or Codex.

Then tell me what is still on disk and leave all of it alone unless I ask you to delete it.
```

### Uninstall manually

#### 1. Remove the MCP entry

Edit your coding tool's MCP config file and delete the `kerno` server block.

#### 2. Stop the agent and remove its binaries

```bash
kerno uninstall
```

This stops the running agent, shuts down its containers, and removes the downloaded agent runtime from `~/.kerno/assets/`.

#### 3. Uninstall the CLI and the plugin

```bash
npm uninstall -g @kerno/cli
```

If you installed the plugin, remove it as well. In Claude Code:

```
/plugin uninstall kerno@kerno
```

In Cursor, remove it from Settings → Plugins. In Codex, remove it from `/plugins`.

### What Kerno leaves behind

`kerno uninstall` clears `~/.kerno/assets/` and nothing else. The following stay on your machine until you remove them yourself:

| Location                     | What it holds                                                 |
| ---------------------------- | ------------------------------------------------------------- |
| `~/.kerno/workspaces/`       | Per-workspace snapshots, indexed data, prompt cache, and logs |
| `.kerno/` in each repository | Your scenarios, baselines, and workspace config               |
| OS keychain                  | Your Kerno login credentials                                  |

Delete `~/.kerno/` if you want the local data gone. Keep each repository's `.kerno/` directory if you may reinstall later, since it holds the test suites Kerno generated for that codebase.

### Resources

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><i class="fa-comment-question" style="color:$info;">:comment-question:</i> <strong>Support</strong></td><td>Get help from the Kerno team.</td><td><a href="https://discord.gg/k8yA9tZdP9">https://discord.gg/k8yA9tZdP9</a></td></tr><tr><td><i class="fa-lightbulb" style="color:$info;">:lightbulb:</i> <strong>FAQs</strong></td><td>Get answers to common questions.</td><td><a href="/pages/zJKOG1wiwndWnBdcDH4o">/pages/zJKOG1wiwndWnBdcDH4o</a></td></tr><tr><td><i class="fa-shield-check" style="color:$info;">:shield-check:</i> <strong>Security</strong></td><td>Learn how Kerno handles your code and data.</td><td><a href="/pages/a868OKb6TDxWBmJlCO1H">/pages/a868OKb6TDxWBmJlCO1H</a></td></tr></tbody></table>