Uninstall Guide

How to completely remove Bob the Fixer from your system.

Overview

The uninstaller is a 4-step process that removes:

Component	Removed
SonarQube container	✓
PostgreSQL container	✓
Container volumes (data)	✓
MCP server registrations	✓
Configuration files (.env, logs)	✓
Build output (dist)	✓
Node.js dependencies (node_modules)	✓
~/.bobthefixer/ directory	✓

Not removed:

• Docker/Podman
• AI CLIs (Claude, Gemini, GitHub Copilot, OpenAI)
• Node.js and npm
• Source code

Running the Uninstaller

cd /path/to/bob-the-fixer
./uninstall.sh

You'll be asked to confirm before proceeding.

What Happens

Step 1: Remove Containers

The uninstaller detects your container runtime (Docker or Podman) and removes:

• bobthefixer_sonarqube - SonarQube server
• bobthefixer_postgres - PostgreSQL database
• All associated volumes:
  • bobthefixer_postgres_data
  • bobthefixer_sonarqube_data
  • bobthefixer_sonarqube_extensions
  • bobthefixer_sonarqube_logs

Data Loss

All SonarQube analysis data and project configurations stored in volumes will be permanently deleted.

Step 2: Remove MCP Server

Bob the Fixer is unregistered from all detected AI CLIs:

Claude:

claude mcp remove bob-the-fixer --scope user

Gemini:

gemini mcp remove bob-the-fixer --scope user

OpenAI Codex:

codex mcp remove bob-the-fixer

GitHub Copilot: Removes the bob-the-fixer entry from ~/.copilot/mcp-config.json

Step 3: Clean Configuration

Removes local configuration files:

File/Directory	Description
.env	Environment configuration
logs/	Log files
packages/core/dist/	Build output
node_modules/	Root dependencies
packages/core/node_modules/	Core package dependencies
~/.bobthefixer/	Credentials and local cache

Step 4: Verification

The uninstaller verifies:

1. No containers with bobthefixer prefix exist
2. MCP server is not registered in any CLI
3. Configuration files have been removed

Manual Uninstallation

If the uninstaller fails or you prefer manual control:

Remove Containers

# Using Docker
docker stop bobthefixer_sonarqube bobthefixer_postgres
docker rm bobthefixer_sonarqube bobthefixer_postgres
docker volume rm bobthefixer_postgres_data bobthefixer_sonarqube_data \
  bobthefixer_sonarqube_extensions bobthefixer_sonarqube_logs

# Using Podman
podman stop bobthefixer_sonarqube bobthefixer_postgres
podman rm bobthefixer_sonarqube bobthefixer_postgres
podman volume rm bobthefixer_postgres_data bobthefixer_sonarqube_data \
  bobthefixer_sonarqube_extensions bobthefixer_sonarqube_logs

Remove MCP Server

# Claude
claude mcp remove bob-the-fixer --scope user

# Gemini
gemini mcp remove bob-the-fixer --scope user

# OpenAI Codex
codex mcp remove bob-the-fixer

# GitHub Copilot - edit config file
# Remove "bob-the-fixer" entry from ~/.copilot/mcp-config.json

Remove Configuration

cd /path/to/bob-the-fixer

# Remove config files
rm -f .env
rm -rf logs

# Remove build output
rm -rf packages/core/dist

# Remove dependencies
rm -rf node_modules
rm -rf packages/core/node_modules

Partial Cleanup

To keep SonarQube data but remove MCP registration:

# Only remove MCP server (keeps containers and data)
claude mcp remove bob-the-fixer --scope user
gemini mcp remove bob-the-fixer --scope user

To stop containers but keep data:

# Stop without removing volumes
docker stop bobthefixer_sonarqube bobthefixer_postgres

Reinstallation

After uninstalling, you can reinstall at any time:

cd /path/to/bob-the-fixer
./install.sh

The installer will:

1. Detect missing components
2. Rebuild the MCP server
3. Start fresh containers
4. Register with your AI CLIs

Troubleshooting Uninstall

Containers Won't Stop

# Force stop
docker kill bobthefixer_sonarqube bobthefixer_postgres

# Then remove
docker rm -f bobthefixer_sonarqube bobthefixer_postgres

Volumes Won't Remove

# Check what's using them
docker volume inspect bobthefixer_postgres_data

# Force remove
docker volume rm -f bobthefixer_postgres_data

MCP Still Registered

If MCP removal fails, manually edit your config:

Claude: Check ~/.config/claude-code/ for MCP configurations

Gemini: Check ~/.config/gemini/ for MCP configurations

GitHub Copilot: Edit ~/.copilot/mcp-config.json:

{
  "mcpServers": {
    // Remove the "bob-the-fixer" entry
  }
}

Permission Errors

# Run with sudo if needed
sudo ./uninstall.sh

# Or fix permissions first
sudo chown -R $(whoami) /path/to/bob-the-fixer
./uninstall.sh

Uninstall Log

The uninstaller creates a log at:

/tmp/bob-uninstall-YYYYMMDD_HHMMSS.log

Check this log if you encounter issues during uninstallation.

Complete Removal

To completely remove everything including source code:

# Run uninstaller first
cd /path/to/bob-the-fixer
./uninstall.sh

# Then remove source code
cd ..
rm -rf bob-the-fixer

What's Preserved

After uninstallation, these remain on your system:

Component	Location	Why Preserved
Docker/Podman	System	May be used by other projects
AI CLIs	Global npm	May be used for other purposes
Node.js	System	Development dependency
Source code	Your directory	For potential reinstallation

To remove these, use their respective uninstall methods:

# Remove AI CLIs
npm uninstall -g @anthropic-ai/claude-code
npm uninstall -g @google/gemini-cli
npm uninstall -g @openai/codex

# Docker Desktop: Use the uninstaller from Applications
# Podman: brew uninstall podman (macOS)