Uninstall

Kolbo Code ships with a built-in uninstall command that removes the binary, configuration, cached data, and (on curl-based installs) even the shell PATH entry it added during installation.

Built-in uninstaller

kolbo uninstall

The command detects how Kolbo Code was installed (npm, bun, pnpm, yarn, brew, scoop, choco, or curl) and removes everything appropriate for that installation method. It prints a summary of what it is about to remove and asks for confirmation before touching anything.

Options

Flag	Description
`--keep-config`, `-c`	Preserve your config files in `~/.kolbo/`
`--keep-data`, `-d`	Preserve sessions, snapshots, and stored data
`--dry-run`	Show what would be removed without removing it
`--force`, `-f`	Skip the confirmation prompt

Example: preview without removing

kolbo uninstall --dry-run

Example: remove everything, no prompts

kolbo uninstall --force

Example: uninstall the binary but keep your config and sessions

kolbo uninstall --keep-config --keep-data

Manual uninstall by package manager

If for any reason kolbo uninstall is not available (e.g. the binary is already gone), run the command that matches your install method:

# npm
npm uninstall -g @kolbo/kolbo-code

# bun
bun remove -g @kolbo/kolbo-code

# pnpm
pnpm remove -g @kolbo/kolbo-code

# yarn
yarn global remove @kolbo/kolbo-code

# Homebrew
brew uninstall kolbo

# Scoop
scoop uninstall kolbo

# Chocolatey (run from an elevated shell)
choco uninstall kolbo -y

What gets removed

The uninstaller walks the following directories and removes the ones you did not mark --keep-*:

Label	Path (macOS / Linux)	Purpose
Data	`~/.local/share/kolbo` (or `~/Library/Application Support/kolbo`)	Sessions, auth token, logs
Cache	`~/.cache/kolbo` (or `~/Library/Caches/kolbo`)	Downloaded assets, snapshots
Config	`~/.config/kolbo` (or `~/Library/Application Support/kolbo`)	`tui.json`, user config
State	`~/.local/state/kolbo`	Ephemeral runtime state

On Windows these live under %LOCALAPPDATA%\kolbo.

If Kolbo Code was installed via the curl installer (the one that drops a binary into ~/.kolbo/bin and edits your shell rc file), the uninstaller also:

Removes the binary at ~/.kolbo/bin/kolbo.
Strips the # kolbo block and any export PATH=...:~/.kolbo/bin / fish_add_path ~/.kolbo/bin line from your shell config.

Leftovers to clean manually

The uninstaller does not touch:

Skills you installed yourself in ~/.claude/skills/ or .kolbo/skills/
Any per-project .kolbo/ or .claude/ directories in your repos
Your Kolbo.AI account (manage that at app.kolbo.ai)

If you want a clean slate, remove those directories manually after running kolbo uninstall.

On this page