/uninstall - Remove CODITECT

Safely remove the CODITECT installation from your system.

Usage

# Interactive uninstall (with confirmation)
/uninstall

# Uninstall without confirmation
/uninstall --yes

# Preserve user data (context database, session logs)
/uninstall --keep-data

# Preview what will be removed (dry run)
/uninstall --dry-run

System Prompt

EXECUTION DIRECTIVE: When the user invokes /uninstall, execute the uninstall script:

python3 ~/.coditect/scripts/uninstall-coditect.py $ARGS

DO NOT:

• Skip the confirmation prompt unless --yes is passed
• Remove data without warning the user
• Modify the script behavior

What It Removes

1. Background Services

   • Stops context watcher daemon
   • Removes launchd/systemd service files

2. Symlinks

   • ~/.coditect (home directory symlink)
   • ~/PROJECTS/.coditect (projects symlink)
   • ~/PROJECTS/.claude (Claude compatibility symlink)

3. Claude Code Settings

   • Removes CODITECT statusLine configuration
   • Removes CODITECT hooks from settings.json

4. Installation Directory

   • macOS: ~/Library/Application Support/CODITECT/core/
   • Linux: ~/.local/share/coditect/core/

User Data

The following data can be preserved with --keep-data:

Data	Location	Contains
Org Database (CRITICAL)	context-storage/org.db	ADR-118 Tier 2: Decisions, skill_learnings, error_solutions
Sessions Database	context-storage/sessions.db	ADR-118 Tier 3: Messages, tool_analytics, token_economics
Platform Database	context-storage/platform.db	ADR-118 Tier 1: Component index (regenerable)
Session Logs	session-logs/	Machine-specific session exports
Logs	logs/	Application logs

Default behavior: User data is DELETED unless --keep-data is specified.

Output

CODITECT Uninstall
==================

  Installation Details:
    Version: 1.0.0
    Location: /Users/you/Library/Application Support/CODITECT/core
    Size: 45.2 MB
    Machine ID: abc123...

  Symlinks:
    - /Users/you/.coditect
    - /Users/you/PROJECTS/.coditect
    - /Users/you/PROJECTS/.claude

  User Data:
    - Context database (sessions, messages, decisions)
    - 12 session log(s)
    - Size: 8.5 MB

  WARNING: User data will be permanently deleted!
           Use --keep-data to preserve your data

  Uninstall CODITECT and DELETE ALL DATA? [y/N]: y
  Backup user data before removal? [Y/n]: y

  Stopping services...
  ✓ Stopped context watcher service

  Removing symlinks...
  ✓ Removed: /Users/you/.coditect
  ✓ Removed: /Users/you/PROJECTS/.coditect
  ✓ Removed: /Users/you/PROJECTS/.claude

  Cleaning Claude Code settings...
  ✓ Cleaned Claude Code settings

  Removing installation...
  ✓ Removed: /Users/you/Library/Application Support/CODITECT/core

  ✓ CODITECT has been uninstalled

  ℹ To reinstall: curl -fsSL https://coditect.ai/install | python3

Options

Option	Description
--yes, -y	Skip confirmation prompt
--keep-data, -k	Preserve user data (context database, session logs)
--dry-run, -n	Preview what would be removed without making changes

Safety Features

• Confirmation required - Must type 'y' to proceed (unless --yes)
• Data warning - Warns about data deletion before proceeding
• Backup offer - Offers to backup user data to Desktop before removal
• Dry run mode - Preview all changes without removing anything
• Submodule safety - Will not uninstall from development submodules

Reinstallation

After uninstalling, you can reinstall CODITECT:

# Quick install
curl -fsSL https://coditect.ai/install | python3

# Or manual install
cd ~/PROJECTS
git clone https://github.com/coditect-ai/coditect-core.git
python3 coditect-core/scripts/CODITECT-CORE-INITIAL-SETUP.py

Related

• /update - Update CODITECT to the latest version
• /orient - Session orientation (verifies installation)
• ~/.coditect/VERSION - Local version file

Files

File	Purpose
~/.coditect/scripts/uninstall-coditect.py	Uninstall script
~/.claude/settings.json	Claude Code settings (cleaned)
~/Library/LaunchAgents/ai.coditect.context-watcher.plist	Launchd service (removed)

---

ADR: ADR-066-context-watcher-service.md (Removal Mechanism section)