prjct-cli 0.4.2 → 0.4.4

package/CHANGELOG.md

@@ -7,6 +7,123 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Coming Soon
+- **Windows Compatibility** - Native Windows support
+  - PowerShell and CMD command execution
+  - Windows path handling (`%USERPROFILE%\.prjct-cli\`)
+  - Windows-specific installation scripts
+  - Cross-platform file operations
+  - Windows Terminal integration
+
+## [0.4.4] - 2025-10-02
+
+### Added
+- **Automatic Editor Command Updates** - Commands auto-update when npm package is updated
+  - New `core/editors-config.js` tracks which editors user has installed commands to
+  - Stores editor selections in `~/.prjct-cli/config/installed-editors.json`
+  - Post-install hook (`scripts/post-install.js`) auto-updates commands after `npm update -g prjct-cli`
+  - **Auto-installation on first install** - Detects AI editors and installs commands automatically
+  - Ensures version consistency across all configured editors (Claude, Cursor, Windsurf, Codex)
+  - No manual reinstallation needed - updates happen automatically
+  - Respects user's original editor choices from initial setup
+
+- **Automatic Cleanup on Uninstall** - Clean uninstallation removes all traces
+  - New `scripts/preuninstall.js` runs before `npm uninstall -g prjct-cli`
+  - Automatically removes commands from all tracked editors
+  - Deletes tracking configuration from `~/.prjct-cli/config/`
+  - Added `uninstallFromEditor()` and `uninstallFromAll()` methods to command installer
+  - Added `deleteConfig()` method to editors config
+  - Prevents orphaned commands when package is uninstalled
+  - Clean exit even if cleanup fails (doesn't block uninstall)
+
+- **Automatic Data Migration** - Seamless upgrade from v0.1.0 to v0.4.4
+  - Post-install hook automatically detects legacy `.prjct/` projects
+  - Migrates data from local structure to new global architecture (`~/.prjct-cli/projects/{id}/`)
+  - Scans common project directories (Projects, Documents, Developer, Code, etc.)
+  - Preserves all project data during migration (now, next, shipped, ideas, memory)
+  - Cleans up legacy directories while keeping config for compatibility
+  - No user intervention required - migration happens automatically on update
+  - Uses existing battle-tested `core/migrator.js` system
+
+### Changed
+- **Improved Command Tracking** - Always track editor installations for better update management
+  - Modified `installToSelected()` to always save editor config (removed `!forceUpdate` restriction)
+  - Ensures tracking happens even during force updates
+  - Enables reliable auto-updates across all configured editors
+
+### Technical Details
+- **Post-Install Hook**: Runs after `npm install -g prjct-cli` or `npm update -g prjct-cli`
+  - First install: Auto-detects editors and installs commands
+  - Updates: Checks version change and auto-updates commands in tracked editors
+  - **Migration**: Automatically detects and migrates legacy projects from v0.1.0
+  - Silent operation with debug mode via `DEBUG=1` environment variable
+- **Pre-Uninstall Hook**: Runs before `npm uninstall -g prjct-cli`
+  - Reads tracking config to find all installed editors
+  - Removes command directories from each editor
+  - Cleans up tracking configuration
+  - Fails gracefully to not block uninstall
+- **Migration System**: Automatic upgrade path from v0.1.0 to v0.4.4
+  - Scans common project directories (fast, non-intrusive)
+  - Migrates local `.prjct/` to global `~/.prjct-cli/projects/{id}/`
+  - Preserves all data: core, progress, planning, analysis, memory layers
+  - Cleans legacy directories while keeping compatibility config
+  - Zero data loss, seamless upgrade experience
+
+## [0.4.3] - 2025-10-02
+
+### Added
+- **Automatic Editor Command Updates** - Commands auto-update when npm package is updated
+  - New `core/editors-config.js` tracks which editors user has installed commands to
+  - Stores editor selections in `~/.prjct-cli/config/installed-editors.json`
+  - Post-install hook (`scripts/post-install.js`) auto-updates commands after `npm update -g prjct-cli`
+  - **Auto-installation on first install** - Detects AI editors and installs commands automatically
+  - Ensures version consistency across all configured editors (Claude, Cursor, Windsurf, Codex)
+  - No manual reinstallation needed - updates happen automatically
+  - Respects user's original editor choices from initial setup
+
+- **Automatic Cleanup on Uninstall** - Clean uninstallation removes all traces
+  - New `scripts/preuninstall.js` runs before `npm uninstall -g prjct-cli`
+  - Automatically removes commands from all tracked editors
+  - Deletes tracking configuration from `~/.prjct-cli/config/`
+  - Added `uninstallFromEditor()` and `uninstallFromAll()` methods to command installer
+  - Added `deleteConfig()` method to editors config
+  - Prevents orphaned commands when package is uninstalled
+  - Clean exit even if cleanup fails (doesn't block uninstall)
+
+- **GitHub Packages Support** - Dual registry publication for better reliability
+  - Package now published to both npm and GitHub Packages automatically
+  - GitHub Actions workflow updated to publish to both registries in parallel
+  - Added comprehensive GitHub Packages documentation (`docs/GITHUB_PACKAGES.md`)
+  - Includes `.npmrc.example` for easy local configuration
+  - Provides fallback option if npm registry is unavailable
+  - Free hosting for public repositories with automatic authentication
+
+### Changed
+- **Installation Documentation** - Updated README with dual installation options
+  - Primary: npm registry (recommended for most users)
+  - Alternative: GitHub Packages (for advanced users or npm fallback)
+  - Clear instructions for both installation methods
+
+- **Command Installer Improvements**
+  - `installToSelected()` now always saves editor config (removed force-update restriction)
+  - Better tracking ensures updates work correctly even for force updates
+  - Improved error handling and reporting
+
+### Technical Details
+- **Editor Tracking**: Configuration saved after all successful command installations
+- **Post-Install Hook**:
+  - Runs only for global installations, skips for local/dev installs
+  - Auto-detects and installs to all AI editors on first install
+  - Auto-updates commands when version changes
+- **Pre-Uninstall Hook**:
+  - Runs only for global uninstallations
+  - Removes slash commands from `~/.claude/`, `~/.cursor/`, `~/.windsurf/`
+  - Removes AGENTS.md from `~/.codex/` if present
+  - Deletes tracking configuration
+- **Version Detection**: Compares current version with last installed version
+- **Force Update**: Automatically updates commands when version changes
+- **Parallel Publication**: npm and GitHub Packages jobs run simultaneously for faster releases
+
 ## [0.4.2] - 2025-10-02
 
 ### Fixed
@@ -21,14 +138,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Removed obsolete install.sh and setup.sh copying from build script
   - Cleaner and faster website builds
 
-### Coming Soon
-- **Windows Compatibility** - Native Windows support
-  - PowerShell and CMD command execution
-  - Windows path handling (`%USERPROFILE%\.prjct-cli\`)
-  - Windows-specific installation scripts
-  - Cross-platform file operations
-  - Windows Terminal integration
-
 ## [0.4.1] - 2025-10-01
 
 ### Added

package/README.md

@@ -46,6 +46,8 @@ Each agent gets optimized output:
 
 ## ⚡ Installation
 
+### From npm (Recommended)
+
 Install prjct-cli globally using npm:
 
 ```bash
@@ -65,6 +67,16 @@ pnpm add -g prjct-cli
 bun install -g prjct-cli
 ```
 
+### From GitHub Packages
+
+You can also install from GitHub Packages:
+
+```bash
+npm install -g @jlopezlira/prjct-cli --registry=https://npm.pkg.github.com
+```
+
+For easier installation from GitHub Packages, see [GitHub Packages Setup](docs/GITHUB_PACKAGES.md).
+
 **Requirements**: Node.js 18 or higher
 
 > **Note**: The CLI automatically detects updates and notifies you when a new version is available. Simply run `npm update -g prjct-cli` to upgrade.

package/core/command-installer.js

@@ -403,6 +403,7 @@ For detailed implementation, see prjct-cli documentation.
 
     const results = {}
     const installedTo = []
+    const successfulEditors = []
 
     for (const editorKey of selectedEditors) {
       const editor = this.editors[editorKey]
@@ -426,6 +427,7 @@ For detailed implementation, see prjct-cli documentation.
       results[editorKey] = await this.installToEditor(editorKey, forceUpdate)
       if (results[editorKey].success) {
         installedTo.push(editor.name)
+        successfulEditors.push(editorKey)
       }
     }
 
@@ -442,6 +444,11 @@ For detailed implementation, see prjct-cli documentation.
     const totalUpdated = Object.values(results)
       .reduce((sum, r) => sum + (r.updated || 0), 0)
 
+    // Always save editor selections to config for tracking updates
+    if (successfulEditors.length > 0) {
+      await this.saveEditorConfig(successfulEditors)
+    }
+
     return {
       success: true,
       editors: installedTo,
@@ -667,6 +674,36 @@ This command uses the global prjct architecture:
     return lines.join('\n')
   }
 
+  /**
+   * Save editor configuration to track installed editors
+   * @param {string[]} editors - Array of successfully installed editor keys
+   * @returns {Promise<void>}
+   */
+  async saveEditorConfig(editors) {
+    try {
+      const editorsConfig = require('./editors-config')
+      const packageJson = require('../package.json')
+
+      // Build paths object
+      const paths = {}
+      for (const editorKey of editors) {
+        const editor = this.editors[editorKey]
+        if (editor) {
+          paths[editorKey] = editor.commandsPath
+        }
+      }
+
+      await editorsConfig.saveConfig(
+        editors,
+        paths,
+        packageJson.version,
+      )
+    } catch (error) {
+      // Don't fail installation if config save fails
+      console.error('[command-installer] Error saving editor config:', error.message)
+    }
+  }
+
   /**
    * Install Context7 MCP configuration for all detected editors
    * @returns {Promise<Object>} Installation results
@@ -770,6 +807,119 @@ This command uses the global prjct architecture:
 
     return results
   }
+
+  /**
+   * Uninstall commands from a specific editor
+   * @param {string} editorKey - Editor identifier (claude, cursor, codex, windsurf)
+   * @returns {Promise<Object>} Uninstallation result
+   */
+  async uninstallFromEditor(editorKey) {
+    const editor = this.editors[editorKey]
+
+    if (!editor) {
+      return { success: false, editor: editorKey, message: `Unknown editor: ${editorKey}` }
+    }
+
+    try {
+      switch (editor.format) {
+        case 'slash-commands':
+          // Remove the /p commands directory
+          await fs.rm(editor.commandsPath, { recursive: true, force: true })
+          return {
+            success: true,
+            editor: editor.name,
+            path: editor.commandsPath,
+            message: `Removed slash commands from ${editor.name}`,
+          }
+
+        case 'agents-md':
+          // Remove AGENTS.md if it exists
+          const exists = await this.fileExists(editor.commandsPath)
+          if (exists) {
+            await fs.unlink(editor.commandsPath)
+          }
+          return {
+            success: true,
+            editor: editor.name,
+            path: editor.commandsPath,
+            message: `Removed AGENTS.md from ${editor.name}`,
+          }
+
+        case 'workflows':
+          // Remove all p_*.md workflow files
+          try {
+            const files = await fs.readdir(editor.commandsPath)
+            const prjctWorkflows = files.filter(f => f.startsWith('p_') && f.endsWith('.md'))
+
+            for (const file of prjctWorkflows) {
+              await fs.unlink(path.join(editor.commandsPath, file))
+            }
+
+            return {
+              success: true,
+              editor: editor.name,
+              path: editor.commandsPath,
+              removed: prjctWorkflows.length,
+              message: `Removed ${prjctWorkflows.length} workflows from ${editor.name}`,
+            }
+          } catch (error) {
+            // Directory might not exist, that's ok
+            return {
+              success: true,
+              editor: editor.name,
+              message: `No workflows found in ${editor.name}`,
+            }
+          }
+
+        default:
+          return {
+            success: false,
+            editor: editor.name,
+            message: `Unknown format: ${editor.format}`,
+          }
+      }
+    } catch (error) {
+      return {
+        success: false,
+        editor: editor.name,
+        message: `Uninstall failed: ${error.message}`,
+      }
+    }
+  }
+
+  /**
+   * Uninstall commands from all tracked editors
+   * @returns {Promise<Object>} Uninstallation results
+   */
+  async uninstallFromAll() {
+    const editorsConfig = require('./editors-config')
+    const trackedEditors = await editorsConfig.getTrackedEditors()
+
+    if (trackedEditors.length === 0) {
+      return {
+        success: true,
+        message: 'No editors tracked, nothing to uninstall',
+        results: {},
+      }
+    }
+
+    const results = {}
+    const successfulEditors = []
+
+    for (const editorKey of trackedEditors) {
+      results[editorKey] = await this.uninstallFromEditor(editorKey)
+      if (results[editorKey].success) {
+        successfulEditors.push(this.editors[editorKey]?.name || editorKey)
+      }
+    }
+
+    return {
+      success: true,
+      editors: successfulEditors,
+      totalRemoved: successfulEditors.length,
+      results,
+    }
+  }
 }
 
 module.exports = new CommandInstaller()

package/core/editors-config.js

@@ -0,0 +1,178 @@
+const fs = require('fs').promises
+const path = require('path')
+const os = require('os')
+
+/**
+ * EditorsConfig - Manages installed editors tracking configuration
+ *
+ * Tracks which AI editors user has installed prjct commands to,
+ * enabling automatic updates when npm package is updated.
+ *
+ * Config location: ~/.prjct-cli/config/installed-editors.json
+ *
+ * @version 0.4.2
+ */
+class EditorsConfig {
+  constructor() {
+    this.homeDir = os.homedir()
+    this.configDir = path.join(this.homeDir, '.prjct-cli', 'config')
+    this.configFile = path.join(this.configDir, 'installed-editors.json')
+  }
+
+  /**
+   * Ensure config directory exists
+   */
+  async ensureConfigDir() {
+    try {
+      await fs.mkdir(this.configDir, { recursive: true })
+    } catch (error) {
+      console.error('[editors-config] Error creating config directory:', error.message)
+    }
+  }
+
+  /**
+   * Load installed editors configuration
+   * @returns {Promise<Object|null>} Configuration object or null if not found
+   */
+  async loadConfig() {
+    try {
+      const content = await fs.readFile(this.configFile, 'utf-8')
+      return JSON.parse(content)
+    } catch (error) {
+      if (error.code === 'ENOENT') {
+        return null
+      }
+      console.error('[editors-config] Error loading config:', error.message)
+      return null
+    }
+  }
+
+  /**
+   * Save installed editors configuration
+   * @param {string[]} editors - Array of editor keys (e.g., ['claude', 'cursor'])
+   * @param {Object} paths - Object mapping editor keys to installation paths
+   * @param {string} version - Current prjct-cli version
+   * @returns {Promise<boolean>} Success status
+   */
+  async saveConfig(editors, paths, version) {
+    try {
+      await this.ensureConfigDir()
+
+      const config = {
+        version,
+        editors,
+        lastInstall: new Date().toISOString(),
+        paths,
+      }
+
+      await fs.writeFile(
+        this.configFile,
+        JSON.stringify(config, null, 2),
+        'utf-8',
+      )
+
+      return true
+    } catch (error) {
+      console.error('[editors-config] Error saving config:', error.message)
+      return false
+    }
+  }
+
+  /**
+   * Get tracked editors from configuration
+   * @returns {Promise<string[]>} Array of editor keys
+   */
+  async getTrackedEditors() {
+    const config = await this.loadConfig()
+    return config ? config.editors : []
+  }
+
+  /**
+   * Get editor paths from configuration
+   * @returns {Promise<Object>} Object mapping editor keys to paths
+   */
+  async getEditorPaths() {
+    const config = await this.loadConfig()
+    return config ? config.paths : {}
+  }
+
+  /**
+   * Get last installed version
+   * @returns {Promise<string|null>} Version string or null
+   */
+  async getLastVersion() {
+    const config = await this.loadConfig()
+    return config ? config.version : null
+  }
+
+  /**
+   * Check if version has changed since last install
+   * @param {string} currentVersion - Current version to compare
+   * @returns {Promise<boolean>} True if version has changed
+   */
+  async hasVersionChanged(currentVersion) {
+    const lastVersion = await this.getLastVersion()
+    return lastVersion !== null && lastVersion !== currentVersion
+  }
+
+  /**
+   * Update version in configuration
+   * @param {string} version - New version to save
+   * @returns {Promise<boolean>} Success status
+   */
+  async updateVersion(version) {
+    try {
+      const config = await this.loadConfig()
+      if (!config) {
+        return false
+      }
+
+      config.version = version
+      config.lastInstall = new Date().toISOString()
+
+      await fs.writeFile(
+        this.configFile,
+        JSON.stringify(config, null, 2),
+        'utf-8',
+      )
+
+      return true
+    } catch (error) {
+      console.error('[editors-config] Error updating version:', error.message)
+      return false
+    }
+  }
+
+  /**
+   * Check if config file exists
+   * @returns {Promise<boolean>} True if config exists
+   */
+  async configExists() {
+    try {
+      await fs.access(this.configFile)
+      return true
+    } catch {
+      return false
+    }
+  }
+
+  /**
+   * Delete configuration file
+   * Used during uninstallation to clean up tracking data
+   * @returns {Promise<boolean>} Success status
+   */
+  async deleteConfig() {
+    try {
+      const exists = await this.configExists()
+      if (exists) {
+        await fs.unlink(this.configFile)
+      }
+      return true
+    } catch (error) {
+      console.error('[editors-config] Error deleting config:', error.message)
+      return false
+    }
+  }
+}
+
+module.exports = new EditorsConfig()

package/package.json

@@ -1,15 +1,18 @@
 {
   "name": "prjct-cli",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "description": "AI-integrated project management for indie hackers - works with Claude Code, Cursor, and Warp",
   "main": "core/index.js",
   "bin": {
     "prjct": "./bin/prjct"
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
   },
   "scripts": {
+    "postinstall": "node scripts/post-install.js",
+    "preuninstall": "node scripts/preuninstall.js",
     "install-global": "./scripts/install.sh",
     "test": "echo 'No tests configured'",
     "lint": "eslint \"**/*.js\" --ignore-pattern \"node_modules/**\" --ignore-pattern \"website/**\"",
@@ -66,6 +69,8 @@
     "templates/",
     "scripts/install.sh",
     "scripts/verify-installation.sh",
+    "scripts/post-install.js",
+    "scripts/preuninstall.js",
     "LICENSE",
     "README.md",
     "CHANGELOG.md",

package/scripts/post-install.js

@@ -0,0 +1,174 @@
+#!/usr/bin/env node
+
+/**
+ * Post-Install Script
+ *
+ * Runs automatically after `npm install -g prjct-cli` or `npm update -g prjct-cli`.
+ * Auto-updates slash commands in all previously configured editors.
+ *
+ * Flow:
+ * 1. Check if running as global install
+ * 2. Read tracked editors from ~/.prjct-cli/config/installed-editors.json
+ * 3. If config exists and version changed, force-update commands in tracked editors
+ * 4. Update version in config
+ *
+ * @version 0.4.4
+ */
+
+const path = require('path')
+const chalk = require('chalk')
+const { execSync } = require('child_process')
+
+async function main() {
+  try {
+    // Check if this is a global installation
+    const isGlobal = await checkIfGlobalInstall()
+
+    if (!isGlobal) {
+      // Skip post-install for local/dev installations
+      return
+    }
+
+    // Load editors config
+    const editorsConfig = require('../core/editors-config')
+    const configExists = await editorsConfig.configExists()
+
+    if (!configExists) {
+      // First-time install - auto-detect and install to all editors
+      console.log(chalk.cyan('\n🔍 First-time installation detected...\n'))
+
+      // Load command installer
+      const commandInstaller = require('../core/command-installer')
+
+      // Detect available editors
+      const detected = await commandInstaller.detectEditors()
+      const detectedEditors = Object.entries(detected)
+        .filter(([_, info]) => info.detected)
+        .map(([key, _]) => key)
+
+      if (detectedEditors.length === 0) {
+        // No editors detected, user will install manually later
+        console.log(chalk.yellow('ℹ️  No AI editors detected'))
+        console.log(chalk.gray('   Run `prjct install` when you set up Claude Code, Cursor, or Windsurf\n'))
+        return
+      }
+
+      console.log(chalk.cyan(`📦 Installing commands to: ${detectedEditors.map(k => commandInstaller.editors[k]?.name || k).join(', ')}\n`))
+
+      // Install to all detected editors
+      const results = await commandInstaller.installToAll(false)
+
+      if (results.success) {
+        console.log(chalk.green(`✅ Commands installed in: ${results.editors.join(', ')}`))
+        console.log(chalk.gray(`   Commands installed: ${results.totalInstalled}`))
+        console.log(chalk.cyan(`\n✨ prjct-cli ${currentVersion} is ready!\n`))
+      }
+
+      return
+    }
+
+    // Get current package version
+    const packageJson = require('../package.json')
+    const currentVersion = packageJson.version
+
+    // Check if version has changed
+    const versionChanged = await editorsConfig.hasVersionChanged(currentVersion)
+
+    if (!versionChanged) {
+      // Same version, no update needed
+      return
+    }
+
+    // Get tracked editors and paths
+    const trackedEditors = await editorsConfig.getTrackedEditors()
+    const editorPaths = await editorsConfig.getEditorPaths()
+
+    if (trackedEditors.length === 0) {
+      // No editors tracked yet
+      return
+    }
+
+    console.log(chalk.cyan('\n🔄 Updating prjct commands in configured editors...\n'))
+
+    // Load command installer
+    const commandInstaller = require('../core/command-installer')
+
+    // Force-update commands in all tracked editors
+    const results = await commandInstaller.installToSelected(trackedEditors, true)
+
+    if (results.success) {
+      console.log(chalk.green(`✅ Updated commands in: ${results.editors.join(', ')}`))
+      console.log(chalk.gray(`   Commands updated: ${results.totalUpdated}`))
+    } else {
+      console.log(chalk.yellow('⚠️  Some editors could not be updated'))
+    }
+
+    // Update version in config
+    await editorsConfig.updateVersion(currentVersion)
+
+    // Auto-migrate legacy projects (v0.1.0 → v0.4.4)
+    try {
+      console.log(chalk.cyan('\n🔍 Checking for legacy projects to migrate...\n'))
+
+      const migrator = require('../core/migrator')
+
+      // Quick scan of common directories (not entire home directory)
+      const summary = await migrator.migrateAll({
+        deepScan: false,        // Only scan common dirs (fast)
+        removeLegacy: false,    // Keep legacy dirs for safety
+        cleanupLegacy: true,    // Remove old dirs but keep config
+        dryRun: false,          // Actually perform migration
+        interactive: false      // No user prompts during npm install
+      })
+
+      if (summary.successfullyMigrated > 0) {
+        console.log(chalk.green(`✅ Migrated ${summary.successfullyMigrated} legacy project(s) to new structure`))
+        console.log(chalk.gray(`   Data location: ~/.prjct-cli/projects/`))
+      } else if (summary.totalFound > 0 && summary.alreadyMigrated === summary.totalFound) {
+        console.log(chalk.gray('ℹ️  All projects already using new structure'))
+      }
+    } catch (migrationError) {
+      // Don't block install if migration fails
+      if (process.env.DEBUG) {
+        console.error(chalk.yellow('[post-install] Migration warning:'), migrationError.message)
+      }
+    }
+
+    console.log(chalk.cyan(`\n✨ prjct-cli ${currentVersion} is ready!\n`))
+
+  } catch (error) {
+    // Silently fail - don't block npm install
+    // Only log if explicitly debugging
+    if (process.env.DEBUG) {
+      console.error(chalk.red('[post-install] Error:'), error.message)
+    }
+  }
+}
+
+/**
+ * Check if package is being installed globally
+ * @returns {Promise<boolean>} True if global install
+ */
+async function checkIfGlobalInstall() {
+  try {
+    // Get npm global root directory
+    const globalRoot = execSync('npm root -g', { encoding: 'utf-8' }).trim()
+
+    // Get current package directory
+    const currentDir = path.resolve(__dirname, '..')
+
+    // Check if current directory is under global node_modules
+    return currentDir.startsWith(globalRoot)
+  } catch {
+    return false
+  }
+}
+
+// Run main function
+main().catch(error => {
+  // Silently fail - don't block npm install
+  if (process.env.DEBUG) {
+    console.error('[post-install] Fatal error:', error)
+  }
+  process.exit(0) // Exit with success to not block npm install
+})

package/scripts/preuninstall.js

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+
+/**
+ * Pre-Uninstall Script
+ *
+ * Runs automatically BEFORE `npm uninstall -g prjct-cli`.
+ * Cleans up slash commands from all tracked AI editors.
+ *
+ * Flow:
+ * 1. Check if running as global uninstall
+ * 2. Read tracked editors from ~/.prjct-cli/config/installed-editors.json
+ * 3. Remove all prjct commands from tracked editors
+ * 4. Delete tracking configuration
+ * 5. Clean exit (don't block uninstall)
+ *
+ * @version 0.4.4
+ */
+
+const chalk = require('chalk')
+const { execSync } = require('child_process')
+const path = require('path')
+
+async function main() {
+  try {
+    // Check if this is a global uninstallation
+    const isGlobal = await checkIfGlobalInstall()
+
+    if (!isGlobal) {
+      // Skip cleanup for local/dev uninstalls
+      return
+    }
+
+    // Load editors config
+    const editorsConfig = require('../core/editors-config')
+    const configExists = await editorsConfig.configExists()
+
+    if (!configExists) {
+      // No config, nothing to clean up
+      return
+    }
+
+    console.log(chalk.cyan('\n🧹 Cleaning up prjct commands from AI editors...\n'))
+
+    // Load command installer
+    const commandInstaller = require('../core/command-installer')
+
+    // Uninstall from all tracked editors
+    const results = await commandInstaller.uninstallFromAll()
+
+    if (results.success && results.editors.length > 0) {
+      console.log(chalk.green(`✅ Removed from: ${results.editors.join(', ')}`))
+    }
+
+    // Delete tracking config
+    await editorsConfig.deleteConfig()
+
+    console.log(chalk.green('\n✨ prjct-cli uninstalled cleanly\n'))
+
+  } catch (error) {
+    // Silently fail - don't block npm uninstall
+    // Only log if explicitly debugging
+    if (process.env.DEBUG) {
+      console.error(chalk.red('[preuninstall] Error:'), error.message)
+    }
+  }
+}
+
+/**
+ * Check if package is being uninstalled globally
+ * @returns {Promise<boolean>} True if global uninstall
+ */
+async function checkIfGlobalInstall() {
+  try {
+    // Get npm global root directory
+    const globalRoot = execSync('npm root -g', { encoding: 'utf-8' }).trim()
+
+    // Get current package directory
+    const currentDir = path.resolve(__dirname, '..')
+
+    // Check if current directory is under global node_modules
+    return currentDir.startsWith(globalRoot)
+  } catch {
+    return false
+  }
+}
+
+// Run main function
+main().catch(error => {
+  // Silently fail - don't block npm uninstall
+  if (process.env.DEBUG) {
+    console.error('[preuninstall] Fatal error:', error)
+  }
+  process.exit(0) // Exit with success to not block npm uninstall
+})