uninstall

Stop Second Brain background services and optionally delete local vault and configuration files.

Updated Apr 14, 2026
One-click install
npx skills add https://github.com/viditparashar96/second-brain-claude --skill uninstall-viditparashar96
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: uninstall
Source: https://github.com/viditparashar96/second-brain-claude/tree/main/skills/uninstall
Command: npx skills add https://github.com/viditparashar96/second-brain-claude --skill uninstall-viditparashar96

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a guided, safe way to stop Second Brain background services and remove local configuration and data when a user wants to fully uninstall the system.

Core Features & Use Cases

  • Stop background services: Stops and removes heartbeat, indexer, and reflection processes via platform utilities.
  • Remove desktop integration: Cleans up Claude Desktop MCP configuration if present.
  • Controlled data removal: Prompts the user to choose between deleting the entire vault, preserving the vault while removing other data, or keeping everything intact for reinstallation.

Quick Start

Run the uninstall skill and follow the prompts to stop services and optionally delete your ~/.second-brain data.

Frequently Asked Questions about uninstall

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely stop Second Brain background services before uninstalling?

To safely stop Second Brain background services, you must shut down the heartbeat, indexer, and reflection processes using platform utilities. The uninstall process performs a controlled service shutdown to ensure these tasks are fully stopped.

How do I remove Claude Desktop MCP configuration during a clean uninstall?

To remove Claude Desktop MCP configuration during a clean uninstall, the process identifies and cleans up the integration if present. This removes the desktop integration entries left in your configuration files.

Can I preserve my local vault while removing other Second Brain configuration files?

Yes, you can preserve your local vault while removing other configuration files. The uninstall process prompts you to choose between deleting the entire vault, keeping the vault while removing other data, or keeping everything intact for reinstallation.

What permissions are needed to delete the ~/.second-brain directory?

Deleting the ~/.second-brain directory requires filesystem permissions to modify or delete the folder. You also need access to scripts under the plugin root to execute the controlled service shutdown and filesystem cleanup.

What is the best way to completely uninstall Second Brain and its data?

The best way to completely uninstall Second Brain is to run a guided process that stops background services, removes desktop integration, and optionally deletes the local vault and configuration files. This ensures a clean removal of all components.