cf uninstall

Overview

cf uninstall removes the Coding Friend plugin from Claude Code. The cleanup behavior depends on the scope.

Use cf uninstall --agent codex for Codex CLI.

Usage

cf uninstall            # Interactive — asks which scope to uninstall from
cf uninstall --user     # Uninstall from user scope (full cleanup)
cf uninstall --global   # Same as --user
cf uninstall --project  # Uninstall from project scope only
cf uninstall --local    # Uninstall from local scope only
cf uninstall --agent codex
cf uninstall --agent codex --remove-marketplace

Scope-Dependent Behavior

User scope (--user / --global)

Full cleanup — removes everything:

1. Plugin registration — unregisters coding-friend@coding-friend-marketplace from Claude Code
2. Marketplace registration — removes the coding-friend-marketplace entry
3. Plugin cache — deletes ~/.claude/plugins/cache/coding-friend-marketplace/
4. Marketplace clone — deletes ~/.claude/plugins/marketplaces/coding-friend-marketplace/ (if present)
5. Statusline reference — cleans up the statusline command from ~/.claude/settings.json
6. Shell tab completion — removes the completion block from .zshrc or .bashrc
7. Global config (optional) — ~/.coding-friend/ directory (global config, custom skills) — you'll be asked whether to keep or remove it
8. Memory dependencies (optional) — ~/.coding-friend/memory/ directory (better-sqlite3, sqlite-vec, @huggingface/transformers) — asked separately if global config is kept

⚠️ This removes the plugin cache and marketplace data globally. If Coding Friend is also installed at project or local scope in other projects, those installations may stop working. Run cf install --project in those projects to reinstall.

Project scope (--project)

Only removes the plugin registration from .claude/settings.json. Does not touch marketplace, cache, statusline, or shell completion.

Local scope (--local)

Only removes the plugin registration from .claude/settings.local.json. Does not touch marketplace, cache, statusline, or shell completion.

Codex CLI (--agent codex)

Disables coding-friend in ~/.codex/config.toml. Add --remove-marketplace to run codex plugin marketplace remove coding-friend-marketplace as well.

What It Does NOT Do

• Does not uninstall the CLI itself (coding-friend-cli). To do that, run npm uninstall -g coding-friend-cli separately.
• Does not remove per-project config (.coding-friend/ inside your projects).
• Does not restart Claude Code. You'll need to restart manually after uninstalling.

Under the Hood

For user scope, cf uninstall runs:

claude plugin uninstall coding-friend@coding-friend-marketplace
claude plugin marketplace remove coding-friend-marketplace

For project/local scope:

claude plugin uninstall coding-friend@coding-friend-marketplace --scope <scope>

Then manually cleans up cache directories, statusline settings, and shell completion (user scope only).