prjct-cli 0.8.1 → 0.8.3

package/CHANGELOG.md

@@ -7,6 +7,65 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.8.2] - 2025-10-05
+
+### Changed
+
+- **BREAKING: npm-only installation** - Simplified installation to npm-only
+  - ✅ Single command: `npm install -g prjct-cli`
+  - ✅ Automatic setup via postinstall hook
+  - ✅ Auto-migration of legacy projects
+  - ✅ Beautiful ASCII art on installation
+  - ⚠️ `curl -fsSL https://prjct.app/install.sh` now deprecated (shows migration message)
+
+### Added
+
+- **Automatic Post-Install Setup** (`scripts/postinstall.js`)
+  - Runs automatically after `npm install -g prjct-cli`
+  - Detects global vs local installation
+  - Installs/syncs commands to `~/.claude/commands/p/`
+  - Migrates legacy projects automatically
+  - Shows beautiful ASCII art with quick start guide
+
+- **Intelligent Command Sync** (`syncCommands()` in `command-installer.js`)
+  - Detects new commands and installs them
+  - Detects updated commands and refreshes them
+  - **Detects orphaned commands and removes them** (e.g., context.md, stuck.md)
+  - Reports: "✓ 2 nuevos, 5 actualizados, 2 eliminados"
+
+- **Beautiful ASCII Art** (`showAsciiArt()` in `commands.js`)
+  - Displays after `prjct setup` completion
+  - Shows prjct logo with colors
+  - Includes quick start guide
+  - Links to documentation
+
+- **Global Configuration** (`~/.claude/CLAUDE.md`)
+  - Automatically installs/updates global configuration for Claude Code
+  - Provides context for ALL `/p:*` commands across any prjct project
+  - Intelligent merge: preserves user content, updates only prjct section
+  - Includes path resolution rules, file structure, commit format, validation patterns
+  - Installed during `npm install -g prjct-cli` and `prjct setup`
+  - Single source of truth - no need to repeat in 25 command templates
+
+### Fixed
+
+- **Orphaned Commands Cleanup** - Removed deprecated commands
+  - Deleted `context.md` (replaced by context tracking in core)
+  - Deleted `stuck.md` (functionality merged into /p:ask)
+  - Total commands: 27 → 25 (cleaned up)
+
+- **Context Preservation** - All projects now use global storage
+  - Legacy projects in `.prjct/` automatically migrated to `~/.prjct-cli/projects/{id}/`
+  - Only `prjct.config.json` (2KB) remains in project directory
+  - Prevents context loss on updates
+
+### Documentation
+
+- Updated README.md with new installation flow
+- Added "Auto-Setup (NEW in v0.8.2)" section
+- Simplified installation instructions
+- Deprecated manual installation methods
+
 ## [0.8.1] - 2025-10-05
 
 ### Fixed

package/README.md

@@ -73,23 +73,27 @@ For easier installation from GitHub Packages, see [GitHub Packages Setup](docs/G
 
 > **Note**: The CLI automatically detects updates and notifies you when a new version is available. Simply run `npm update -g prjct-cli` to upgrade.
 
-### Editor Command Installation
+### Auto-Setup (NEW in v0.8.2)
 
-After initial installation, `prjct` automatically installs slash commands to Claude:
+After `npm install -g prjct-cli`, setup runs automatically:
 
-```bash
-# Interactive installation (recommended)
-prjct install
+- ✅ Installs `/p:*` commands to `~/.claude`
+- ✅ Migrates legacy projects to global storage
+- ✅ Syncs commands (removes orphans, adds new ones)
+- ✅ Shows beautiful ASCII art with quick start
 
-# Force update existing commands
-prjct install --force
-```
+**That's it!** No manual setup required.
+
+If you need to reconfigure later:
 
-**Installation Location:**
+```bash
+prjct setup          # Reconfigure and sync commands
+prjct setup --force  # Force reinstall all commands
+```
 
-- **Claude Code & Claude Desktop**: `~/.claude/commands/p/`
+**Installation Location**: `~/.claude/commands/p/`
 
-All 18 slash commands (`/p:*`) are automatically installed to Claude Code and Claude Desktop.
+All 25+ slash commands (`/p:*`) are automatically installed to Claude Code and Claude Desktop.
 
 ### Version Management
 

package/core/command-registry.js

@@ -460,12 +460,12 @@ const COMMANDS = [
     category: 'setup',
     description: 'Reconfigure editor installations',
     usage: {
-      claude: null,
+      claude: '/p:setup',
       terminal: 'prjct setup [--force] [--editor <name>]',
     },
     params: '[--force] [--editor <name>]',
     implemented: true,
-    hasTemplate: false,
+    hasTemplate: true,
     icon: 'Settings',
     requiresInit: false,
     blockingRules: null,
@@ -475,12 +475,12 @@ const COMMANDS = [
     category: 'setup',
     description: 'Migrate all legacy projects',
     usage: {
-      claude: null,
+      claude: '/p:migrate-all',
       terminal: 'prjct migrate-all [--deep-scan] [--remove-legacy] [--dry-run]',
     },
     params: '[--deep-scan] [--remove-legacy] [--dry-run]',
     implemented: true,
-    hasTemplate: false,
+    hasTemplate: true,
     icon: 'Database',
     requiresInit: false,
     blockingRules: null,

package/core/commands.js

@@ -2593,7 +2593,26 @@ Agent: ${agent}
       result.errors.forEach((e) => console.log(`   - ${e.file}: ${e.error}`))
     }
 
-    console.log('\n🎉 Setup complete!')
+    // Install global configuration
+    console.log('\n📝 Installing global configuration...')
+    const configResult = await commandInstaller.installGlobalConfig()
+
+    if (configResult.success) {
+      if (configResult.action === 'created') {
+        console.log('✅ Created ~/.claude/CLAUDE.md')
+      } else if (configResult.action === 'updated') {
+        console.log('✅ Updated ~/.claude/CLAUDE.md')
+      } else if (configResult.action === 'appended') {
+        console.log('✅ Added prjct config to ~/.claude/CLAUDE.md')
+      }
+    } else {
+      console.log(`⚠️  ${configResult.error}`)
+    }
+
+    console.log('\n🎉 Setup complete!\n')
+
+    // Show beautiful ASCII art
+    this.showAsciiArt()
 
     return {
       success: true,
@@ -2601,6 +2620,50 @@ Agent: ${agent}
     }
   }
 
+  /**
+   * Show beautiful ASCII art with quick start
+   */
+  showAsciiArt() {
+    const chalk = require('chalk')
+
+    console.log(chalk.cyan('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'))
+    console.log('')
+    console.log(chalk.bold.cyan('   ██████╗ ██████╗      ██╗ ██████╗████████╗'))
+    console.log(chalk.bold.cyan('   ██╔══██╗██╔══██╗     ██║██╔════╝╚══██╔══╝'))
+    console.log(chalk.bold.cyan('   ██████╔╝██████╔╝     ██║██║        ██║'))
+    console.log(chalk.bold.cyan('   ██╔═══╝ ██╔══██╗██   ██║██║        ██║'))
+    console.log(chalk.bold.cyan('   ██║     ██║  ██║╚█████╔╝╚██████╗   ██║'))
+    console.log(chalk.bold.cyan('   ╚═╝     ╚═╝  ╚═╝ ╚════╝  ╚═════╝   ╚═╝'))
+    console.log('')
+    console.log(`   ${chalk.bold.cyan('prjct')}${chalk.magenta('/')}${chalk.green('cli')}  ${chalk.dim.white('v' + VERSION + ' installed')}`)
+    console.log('')
+    console.log(`   ${chalk.yellow('⚡')} Ship faster with zero friction`)
+    console.log(`   ${chalk.green('📝')} From idea to technical tasks in minutes`)
+    console.log(`   ${chalk.cyan('🤖')} Perfect context for AI agents`)
+    console.log('')
+    console.log(chalk.cyan('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'))
+    console.log('')
+    console.log(chalk.bold.cyan('🚀 Quick Start'))
+    console.log(chalk.dim('─────────────────────────────────────────────────'))
+    console.log('')
+    console.log(`  ${chalk.bold('1.')} Initialize your project:`)
+    console.log(`     ${chalk.green('cd your-project && prjct init')}`)
+    console.log('')
+    console.log(`  ${chalk.bold('2.')} Set your current focus:`)
+    console.log(`     ${chalk.green('prjct now "build auth"')}`)
+    console.log('')
+    console.log(`  ${chalk.bold('3.')} Ship & celebrate:`)
+    console.log(`     ${chalk.green('prjct ship "user login"')}`)
+    console.log('')
+    console.log(chalk.dim('─────────────────────────────────────────────────'))
+    console.log('')
+    console.log(`  ${chalk.dim('Documentation:')} ${chalk.cyan('https://prjct.app')}`)
+    console.log(`  ${chalk.dim('Report issues:')} ${chalk.cyan('https://github.com/jlopezlira/prjct-cli/issues')}`)
+    console.log('')
+    console.log(chalk.bold.magenta('Happy shipping! 🚀'))
+    console.log('')
+  }
+
   /**
    * Migrate all legacy projects
    */

package/core/infrastructure/command-installer.js

@@ -210,10 +210,9 @@ class CommandInstaller {
 
   /**
    * Install to all detected editors (alias for installCommands)
-   * @param {boolean} interactive - Whether to show interactive prompts
    * @returns {Promise<Object>} Installation results
    */
-  async installToAll(interactive = false) {
+  async installToAll() {
     return await this.installCommands()
   }
 
@@ -239,6 +238,201 @@ class CommandInstaller {
       return false
     }
   }
+
+  /**
+   * Sync commands - intelligent update that detects and removes orphans
+   * @returns {Promise<Object>} Sync results with added, updated, removed counts
+   */
+  async syncCommands() {
+    const claudeDetected = await this.detectClaude()
+
+    if (!claudeDetected) {
+      return {
+        success: false,
+        error: 'Claude not detected',
+        added: 0,
+        updated: 0,
+        removed: 0,
+      }
+    }
+
+    try {
+      // Ensure commands directory exists
+      await fs.mkdir(this.claudeCommandsPath, { recursive: true })
+
+      // Get current state
+      const templateFiles = await this.getCommandFiles()
+      let installedFiles = []
+
+      try {
+        installedFiles = await fs.readdir(this.claudeCommandsPath)
+        installedFiles = installedFiles.filter((f) => f.endsWith('.md'))
+      } catch {
+        // Directory doesn't exist yet
+        installedFiles = []
+      }
+
+      const results = {
+        success: true,
+        added: 0,
+        updated: 0,
+        removed: 0,
+        errors: [],
+      }
+
+      // Detect new and updated files
+      for (const file of templateFiles) {
+        try {
+          const sourcePath = path.join(this.templatesDir, file)
+          const destPath = path.join(this.claudeCommandsPath, file)
+
+          // Check if file exists in installed location
+          const exists = installedFiles.includes(file)
+
+          if (!exists) {
+            // New file
+            const content = await fs.readFile(sourcePath, 'utf-8')
+            await fs.writeFile(destPath, content, 'utf-8')
+            results.added++
+          } else {
+            // Check if updated (compare modification time or content)
+            const sourceStats = await fs.stat(sourcePath)
+            const destStats = await fs.stat(destPath)
+
+            if (sourceStats.mtime > destStats.mtime) {
+              // Updated file
+              const content = await fs.readFile(sourcePath, 'utf-8')
+              await fs.writeFile(destPath, content, 'utf-8')
+              results.updated++
+            }
+          }
+        } catch (error) {
+          results.errors.push({ file, error: error.message })
+        }
+      }
+
+      // Detect and remove orphaned files
+      const orphans = installedFiles.filter((file) => !templateFiles.includes(file))
+
+      for (const orphan of orphans) {
+        try {
+          const orphanPath = path.join(this.claudeCommandsPath, orphan)
+          await fs.unlink(orphanPath)
+          results.removed++
+        } catch (error) {
+          results.errors.push({ file: orphan, error: error.message })
+        }
+      }
+
+      return results
+    } catch (error) {
+      return {
+        success: false,
+        error: error.message,
+        added: 0,
+        updated: 0,
+        removed: 0,
+      }
+    }
+  }
+
+  /**
+   * Install or update global CLAUDE.md configuration
+   * @returns {Promise<Object>} Result with success status and action taken
+   */
+  async installGlobalConfig() {
+    const claudeDetected = await this.detectClaude()
+
+    if (!claudeDetected) {
+      return {
+        success: false,
+        error: 'Claude not detected',
+        action: 'skipped',
+      }
+    }
+
+    try {
+      // Ensure ~/.claude directory exists
+      const claudeDir = path.join(require('os').homedir(), '.claude')
+      await fs.mkdir(claudeDir, { recursive: true })
+
+      const globalConfigPath = path.join(claudeDir, 'CLAUDE.md')
+      const templatePath = path.join(__dirname, '../../templates/global/CLAUDE.md')
+
+      // Read template content
+      const templateContent = await fs.readFile(templatePath, 'utf-8')
+
+      // Check if global config already exists
+      let existingContent = ''
+      let fileExists = false
+
+      try {
+        existingContent = await fs.readFile(globalConfigPath, 'utf-8')
+        fileExists = true
+      } catch {
+        // File doesn't exist, will create new
+        fileExists = false
+      }
+
+      if (!fileExists) {
+        // Create new file with full template
+        await fs.writeFile(globalConfigPath, templateContent, 'utf-8')
+        return {
+          success: true,
+          action: 'created',
+          path: globalConfigPath,
+        }
+      } else {
+        // File exists - perform intelligent merge
+        const startMarker = '<!-- prjct:start - DO NOT REMOVE THIS MARKER -->'
+        const endMarker = '<!-- prjct:end - DO NOT REMOVE THIS MARKER -->'
+
+        // Check if markers exist in existing file
+        const hasMarkers =
+          existingContent.includes(startMarker) && existingContent.includes(endMarker)
+
+        if (!hasMarkers) {
+          // No markers - append prjct section at the end
+          const updatedContent = existingContent + '\n\n' + templateContent
+          await fs.writeFile(globalConfigPath, updatedContent, 'utf-8')
+          return {
+            success: true,
+            action: 'appended',
+            path: globalConfigPath,
+          }
+        } else {
+          // Markers exist - replace content between markers
+          const beforeMarker = existingContent.substring(
+            0,
+            existingContent.indexOf(startMarker)
+          )
+          const afterMarker = existingContent.substring(
+            existingContent.indexOf(endMarker) + endMarker.length
+          )
+
+          // Extract prjct section from template
+          const prjctSection = templateContent.substring(
+            templateContent.indexOf(startMarker),
+            templateContent.indexOf(endMarker) + endMarker.length
+          )
+
+          const updatedContent = beforeMarker + prjctSection + afterMarker
+          await fs.writeFile(globalConfigPath, updatedContent, 'utf-8')
+          return {
+            success: true,
+            action: 'updated',
+            path: globalConfigPath,
+          }
+        }
+      }
+    } catch (error) {
+      return {
+        success: false,
+        error: error.message,
+        action: 'failed',
+      }
+    }
+  }
 }
 
 module.exports = new CommandInstaller()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prjct-cli",
-  "version": "0.8.1",
+  "version": "0.8.3",
   "description": "Built for Claude - Ship fast, track progress, stay focused. Developer momentum tool for indie hackers.",
   "main": "core/index.js",
   "bin": {
@@ -11,6 +11,8 @@
     "registry": "https://registry.npmjs.org"
   },
   "scripts": {
+    "postinstall": "node scripts/postinstall.js",
+    "update-commands": "node -e \"const installer = require('./core/infrastructure/command-installer'); const i = new installer(); i.syncCommands().then(r => console.log('Commands updated:', r))\"",
     "install-global": "./scripts/install.sh",
     "update": "./scripts/update.sh",
     "test": "vitest run --workspace=vitest.workspace.js",
@@ -74,6 +76,7 @@
     "bin/",
     "core/",
     "templates/",
+    "scripts/postinstall.js",
     "scripts/install.sh",
     "LICENSE",
     "README.md",

package/scripts/install.sh

@@ -1,13 +1,37 @@
 #!/bin/bash
 
-# prjct/cli - Turn ideas into AI-ready roadmaps
-# Usage: curl -fsSL https://prjct.app/install.sh | bash
-# Options:
-#   --force      Force reinstall even if up to date
-#   --dev        Install from development branch
-#   --silent     Silent mode (no interactive prompts)
-#   -y, --yes    Auto-accept all prompts
-#   --help, -h   Show this help message
+# ⚠️ DEPRECATED: This installation method is deprecated
+# Use npm instead: npm install -g prjct-cli
+#
+# This script is kept for backward compatibility only.
+
+# Colors
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+GREEN='\033[0;32m'
+NC='\033[0m'
+
+echo ""
+echo -e "${YELLOW}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+echo -e "${YELLOW}⚠️  This installation method is DEPRECATED${NC}"
+echo -e "${YELLOW}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+echo ""
+echo -e "Please use npm instead:"
+echo ""
+echo -e "  ${GREEN}npm install -g prjct-cli${NC}"
+echo ""
+echo -e "Benefits of npm installation:"
+echo -e "  • ${CYAN}Automatic setup${NC} - No manual configuration needed"
+echo -e "  • ${CYAN}Auto-migration${NC} - Legacy projects migrated automatically"
+echo -e "  • ${CYAN}Beautiful ASCII art${NC} - See the installation success"
+echo -e "  • ${CYAN}Easy updates${NC} - Just npm update -g prjct-cli"
+echo ""
+echo -e "${YELLOW}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+echo ""
+exit 1
+
+# Original install.sh preserved below (not executed)
+# ------------------------------------------------
 
 set -e
 

package/scripts/postinstall.js

@@ -0,0 +1,185 @@
+#!/usr/bin/env node
+
+/**
+ * Post-install hook for prjct-cli
+ *
+ * Runs automatically after npm install -g prjct-cli
+ *
+ * 1. Detects if global install
+ * 2. Installs/syncs commands to ~/.claude/commands/p/
+ * 3. Installs/updates global config to ~/.claude/CLAUDE.md
+ * 4. Shows beautiful ASCII art
+ *
+ * NOTE: Migration is now manual via /p:migrate-all or prjct migrate-all
+ *
+ * @version 0.8.2
+ */
+
+const path = require('path')
+const installer = require('../core/infrastructure/command-installer')
+const { VERSION } = require('../core/utils/version')
+
+// Colors for terminal output
+const CYAN = '\x1b[36m'
+const GREEN = '\x1b[32m'
+const YELLOW = '\x1b[33m'
+const MAGENTA = '\x1b[35m'
+const WHITE = '\x1b[37m'
+const BOLD = '\x1b[1m'
+const DIM = '\x1b[2m'
+const NC = '\x1b[0m' // No Color
+
+async function main() {
+  try {
+    // Detect if this is a global install
+    const isGlobal = await detectGlobalInstall()
+
+    if (!isGlobal) {
+      // Skip postinstall for local development installs
+      console.log(`${DIM}Skipping post-install (local development)${NC}`)
+      return
+    }
+
+    console.log('')
+    console.log(`${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}`)
+    console.log(`${BOLD}${CYAN}🚀 Setting up prjct-cli...${NC}`)
+    console.log(`${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}`)
+    console.log('')
+
+    // Step 1: Detect Claude Code
+    console.log(`${BOLD}[1/3]${NC} Detecting Claude Code...`)
+    const claudeDetected = await installer.detectClaude()
+
+    if (!claudeDetected) {
+      console.log(`${YELLOW}⚠️  Claude Code not detected${NC}`)
+      console.log(`${DIM}Install Claude Code from: https://claude.ai/code${NC}`)
+      console.log(`${DIM}Then run: prjct setup${NC}`)
+      console.log('')
+    } else {
+      console.log(`${GREEN}✓${NC} Claude Code found`)
+      console.log('')
+
+      // Step 2: Install/sync commands
+      console.log(`${BOLD}[2/3]${NC} Installing commands to ~/.claude...`)
+      const syncResult = await installer.syncCommands()
+
+      if (syncResult.success) {
+        const { added, updated, removed } = syncResult
+        const changes = []
+        if (added > 0) changes.push(`${added} nuevos`)
+        if (updated > 0) changes.push(`${updated} actualizados`)
+        if (removed > 0) changes.push(`${removed} eliminados`)
+
+        if (changes.length > 0) {
+          console.log(`${GREEN}✓${NC} ${changes.join(', ')}`)
+        } else {
+          console.log(`${GREEN}✓${NC} All commands up to date`)
+        }
+      } else {
+        console.log(`${YELLOW}⚠️  ${syncResult.error}${NC}`)
+      }
+      console.log('')
+
+      // Step 3: Install global configuration
+      console.log(`${BOLD}[3/3]${NC} Installing global configuration...`)
+      const configResult = await installer.installGlobalConfig()
+
+      if (configResult.success) {
+        if (configResult.action === 'created') {
+          console.log(`${GREEN}✓${NC} Created ~/.claude/CLAUDE.md`)
+        } else if (configResult.action === 'updated') {
+          console.log(`${GREEN}✓${NC} Updated ~/.claude/CLAUDE.md`)
+        } else if (configResult.action === 'appended') {
+          console.log(`${GREEN}✓${NC} Added prjct config to ~/.claude/CLAUDE.md`)
+        }
+      } else {
+        console.log(`${YELLOW}⚠️  ${configResult.error}${NC}`)
+      }
+      console.log('')
+    }
+
+    // Show ASCII art and quick start
+    showAsciiArt()
+
+  } catch (error) {
+    console.error(`${YELLOW}⚠️  Post-install error: ${error.message}${NC}`)
+    console.error(`${DIM}You can run 'prjct setup' manually later${NC}`)
+    // Don't fail the install if post-install has issues
+    process.exit(0)
+  }
+}
+
+/**
+ * Detect if this is a global npm install
+ */
+async function detectGlobalInstall() {
+  // Check if we're being installed globally
+  const npmConfig = process.env.npm_config_global
+  if (npmConfig === 'true') {
+    return true
+  }
+
+  // Check if install location is in global node_modules
+  const installPath = __dirname
+  const globalPaths = [
+    '/usr/local/lib/node_modules',
+    '/usr/lib/node_modules',
+    path.join(process.env.HOME || '', '.npm-global', 'lib', 'node_modules'),
+    path.join(process.env.HOME || '', '.nvm'),
+    path.join(process.env.APPDATA || '', 'npm', 'node_modules')
+  ]
+
+  return globalPaths.some(globalPath => installPath.includes(globalPath))
+}
+
+/**
+ * Show beautiful ASCII art with quick start
+ */
+function showAsciiArt() {
+  console.log(`${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}`)
+  console.log('')
+  console.log(`   ${BOLD}${CYAN}██████╗ ██████╗      ██╗ ██████╗████████╗${NC}`)
+  console.log(`   ${BOLD}${CYAN}██╔══██╗██╔══██╗     ██║██╔════╝╚══██╔══╝${NC}`)
+  console.log(`   ${BOLD}${CYAN}██████╔╝██████╔╝     ██║██║        ██║${NC}`)
+  console.log(`   ${BOLD}${CYAN}██╔═══╝ ██╔══██╗██   ██║██║        ██║${NC}`)
+  console.log(`   ${BOLD}${CYAN}██║     ██║  ██║╚█████╔╝╚██████╗   ██║${NC}`)
+  console.log(`   ${BOLD}${CYAN}╚═╝     ╚═╝  ╚═╝ ╚════╝  ╚═════╝   ╚═╝${NC}`)
+  console.log('')
+  console.log(`   ${BOLD}${CYAN}prjct${NC}${MAGENTA}/${NC}${GREEN}cli${NC}  ${DIM}${WHITE}v${VERSION} installed${NC}`)
+  console.log('')
+  console.log(`   ${YELLOW}⚡${NC} Ship faster with zero friction`)
+  console.log(`   ${GREEN}📝${NC} From idea to technical tasks in minutes`)
+  console.log(`   ${CYAN}🤖${NC} Perfect context for AI agents`)
+  console.log('')
+  console.log(`${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}`)
+  console.log('')
+  console.log(`${BOLD}${CYAN}🚀 Quick Start${NC}`)
+  console.log(`${DIM}─────────────────────────────────────────────────${NC}`)
+  console.log('')
+  console.log(`  ${BOLD}1.${NC} Initialize your project:`)
+  console.log(`     ${GREEN}cd your-project && prjct init${NC}`)
+  console.log('')
+  console.log(`  ${BOLD}2.${NC} Set your current focus:`)
+  console.log(`     ${GREEN}prjct now "build auth"${NC}`)
+  console.log('')
+  console.log(`  ${BOLD}3.${NC} Ship & celebrate:`)
+  console.log(`     ${GREEN}prjct ship "user login"${NC}`)
+  console.log('')
+  console.log(`${DIM}─────────────────────────────────────────────────${NC}`)
+  console.log('')
+  console.log(`  ${DIM}Documentation:${NC} ${CYAN}https://prjct.app${NC}`)
+  console.log(`  ${DIM}Report issues:${NC} ${CYAN}https://github.com/jlopezlira/prjct-cli/issues${NC}`)
+  console.log('')
+  console.log(`${BOLD}${MAGENTA}Happy shipping! 🚀${NC}`)
+  console.log('')
+}
+
+// Run if executed directly
+if (require.main === module) {
+  main().catch(error => {
+    console.error('Fatal error:', error.message)
+    process.exit(0) // Don't fail npm install
+  })
+}
+
+module.exports = main

package/templates/commands/migrate-all.md

@@ -0,0 +1,120 @@
+# /p:migrate-all - Migrate All Legacy Projects
+
+Migrates all legacy prjct projects to the new global storage architecture.
+
+## Usage
+
+```
+/p:migrate-all [--deep-scan] [--remove-legacy] [--dry-run]
+```
+
+## What This Command Does
+
+1. **Scans Global Storage**
+   - Reads all project IDs from `~/.prjct-cli/projects/`
+   - Retrieves project paths from `project.json` files
+
+2. **Detects Legacy Structure**
+   - Checks each project for old `.prjct/` directory structure
+   - Identifies projects that need migration
+
+3. **Migrates Each Project**
+   - Moves data from local `.prjct/` to global `~/.prjct-cli/projects/{id}/`
+   - Creates new minimal local config (`.prjct/prjct.config.json`)
+   - Preserves all project data and history
+
+4. **Cleanup (Optional)**
+   - Removes legacy `.prjct/` directories (with `--remove-legacy`)
+   - Keeps only the new minimal config file
+
+5. **Reports Summary**
+   - Shows migrated, skipped, and failed projects
+   - Lists detailed errors for any failures
+
+## Options
+
+- `--deep-scan`: Scan entire file system (slow but thorough)
+- `--remove-legacy`: Delete old `.prjct/` directories after successful migration
+- `--dry-run`: Show what would be migrated without making changes
+
+## When to Use
+
+- **After major version updates**: When architecture changes
+- **Upgrading from v0.7.x to v0.8.x**: New global storage system
+- **Consolidating projects**: Moving all projects to global storage
+- **Troubleshooting**: If projects aren't working after update
+
+## Migration Process
+
+### Before (Legacy Structure)
+```
+your-project/
+  .prjct/
+    core/
+    planning/
+    progress/
+    memory/
+    analysis/
+    prjct.config.json  # Full config
+```
+
+### After (Global Storage)
+```
+your-project/
+  .prjct/
+    prjct.config.json  # Minimal (projectId + dataPath only)
+
+~/.prjct-cli/projects/3a5667a5dedb/
+  core/
+  planning/
+  progress/
+  memory/
+  analysis/
+  agents/
+  project.json  # System config (authors, version, etc.)
+```
+
+## Output Example
+
+```
+🔄 Scanning for legacy prjct projects...
+
+📁 Found 3 projects in global storage
+
+🔄 Migrating: /Users/jj/Apps/my-app
+   ✅ Migrated successfully
+
+🔄 Migrating: /Users/jj/Apps/other-project
+   ⏭️  Already migrated
+
+📊 Migration Summary:
+   ✅ Migrated: 1
+   ⏭️  Skipped: 1
+   ❌ Failed: 0
+```
+
+## Error Handling
+
+- **No global storage**: Creates directory structure
+- **Missing project paths**: Skips projects with invalid paths
+- **Permission errors**: Reports which projects couldn't be migrated
+- **Already migrated**: Safely skips without changes
+
+## Safety
+
+- **Idempotent**: Safe to run multiple times
+- **Non-destructive**: Original files only removed with `--remove-legacy`
+- **Dry run available**: Test migration with `--dry-run` first
+- **Automatic backup**: Legacy data preserved until explicitly removed
+
+## Requirements
+
+- Write permissions to `~/.prjct-cli/` and project directories
+- Projects must have valid global config in `project.json`
+
+## Notes
+
+- This command does NOT require an initialized prjct project
+- Migration is automatic on install (but manual execution is safer)
+- Always test with `--dry-run` first for large migrations
+- Can be safely interrupted and resumed

package/templates/commands/setup.md

@@ -0,0 +1,74 @@
+# /p:setup - Reconfigure prjct-cli Installation
+
+Reconfigures prjct-cli installation for Claude Code and Claude Desktop.
+
+## Usage
+
+```
+/p:setup [--force]
+```
+
+## What This Command Does
+
+1. **Detects Claude Installation**
+   - Checks if `~/.claude/` directory exists
+   - Verifies Claude Code or Claude Desktop is installed
+
+2. **Syncs Commands to Claude**
+   - Updates all `/p:*` commands in `~/.claude/commands/p/`
+   - Adds new commands from latest version
+   - Updates existing commands with latest templates
+   - Removes orphaned/deprecated commands
+
+3. **Installs/Updates Global Configuration**
+   - Creates or updates `~/.claude/CLAUDE.md`
+   - Adds prjct-specific instructions for Claude
+   - Preserves existing user configuration
+
+4. **Reports Results**
+   - Shows commands added, updated, removed
+   - Displays any errors encountered
+   - Confirms successful installation
+
+## Options
+
+- `--force`: Remove existing installation and reinstall from scratch
+
+## When to Use
+
+- **After updating prjct-cli**: `npm update -g prjct-cli && /p:setup`
+- **Commands not working**: If `/p:*` commands aren't recognized
+- **Fresh installation**: After installing on a new machine
+- **Troubleshooting**: When encountering command-related issues
+
+## Requirements
+
+- Claude Code or Claude Desktop must be installed
+- Write permissions to `~/.claude/` directory
+
+## Output Example
+
+```
+🔧 Reconfiguring prjct...
+
+📦 Installing /p:* commands...
+✓ 3 nuevos, 12 actualizados, 1 eliminado
+
+📝 Installing global configuration...
+✓ Updated ~/.claude/CLAUDE.md
+
+✅ Setup complete!
+```
+
+## Error Handling
+
+- **Claude not detected**: Shows installation URLs for Claude Code/Desktop
+- **Permission errors**: Reports which files couldn't be written
+- **Template errors**: Lists which commands failed to install
+
+## Notes
+
+- This command does NOT migrate projects (use `/p:migrate-all` for that)
+- This command does NOT require an initialized prjct project
+- Safe to run multiple times (idempotent)
+- Will not overwrite user customizations in `~/.claude/CLAUDE.md`

package/templates/global/CLAUDE.md

@@ -0,0 +1,214 @@
+<!-- prjct:start - DO NOT REMOVE THIS MARKER -->
+# prjct Configuration
+
+This section provides global context for all `/p:*` commands across any prjct project.
+
+**Auto-managed by prjct-cli** - This section is automatically updated when you install or update prjct.
+
+## 🎯 Path Resolution for ALL /p:* Commands
+
+**CRITICAL**: Every `/p:*` command operates on **global storage**, NOT local files.
+
+### Resolution Steps:
+
+1. **Detect prjct project**: Check if `.prjct/prjct.config.json` exists in current working directory
+2. **Read config**: Extract `projectId` from `.prjct/prjct.config.json`
+3. **Construct base path**: `~/.prjct-cli/projects/{projectId}/`
+4. **Resolve all file operations**: All paths in command templates are relative to base path
+
+### Examples:
+
+```
+Template says: "Write: core/now.md"
+Actual path:  ~/.prjct-cli/projects/{projectId}/core/now.md
+
+Template says: "Read: memory/context.jsonl"
+Actual path:  ~/.prjct-cli/projects/{projectId}/memory/context.jsonl
+
+Template says: "Update: progress/shipped.md"
+Actual path:  ~/.prjct-cli/projects/{projectId}/progress/shipped.md
+```
+
+### Validation Rules:
+
+- ❌ **NEVER** write to `.prjct/core/now.md` (local project directory)
+- ❌ **NEVER** write to `./core/now.md` (current working directory)
+- ✅ **ALWAYS** write to `~/.prjct-cli/projects/{projectId}/core/now.md` (global storage)
+
+### When NOT in prjct Project:
+
+If `.prjct/prjct.config.json` doesn't exist in current directory:
+- Respond: "No prjct project detected. Initialize first with `/p:init`"
+- Do NOT execute the command
+- Do NOT create files
+
+## 📁 File Structure
+
+All prjct data lives in global storage with session-based architecture:
+
+```
+~/.prjct-cli/projects/{projectId}/
+├── core/                 # Current focus (always small)
+│   ├── now.md           # Single current task
+│   ├── next.md          # Priority queue (max 100 tasks)
+│   └── context.md       # Project context summary
+├── progress/            # Completed work
+│   ├── shipped.md       # Recent ships (last 30 days)
+│   ├── metrics.md       # Aggregated metrics
+│   ├── sessions/        # Daily session logs (JSONL)
+│   │   └── 2025-10/
+│   │       └── 2025-10-05.jsonl
+│   └── archive/         # Monthly archives
+│       └── shipped-2025-10.md
+├── planning/            # Future planning
+│   ├── ideas.md         # Active ideas (last 30 days)
+│   ├── roadmap.md       # Active roadmap (lightweight)
+│   ├── sessions/        # Daily planning sessions (JSONL)
+│   │   └── 2025-10/
+│   │       └── 2025-10-05.jsonl
+│   └── archive/         # Monthly archives
+│       └── roadmap-2025-10.md
+├── analysis/            # Technical analysis
+│   └── repo-summary.md
+├── memory/              # Decision history
+│   ├── context.jsonl    # Global decisions (append-only)
+│   └── sessions/        # Daily context (structured)
+│       └── 2025-10/
+│           └── 2025-10-05.jsonl
+└── agents/              # Dynamic AI agents
+    ├── coordinator.md
+    ├── ux.md
+    ├── fe.md
+    ├── be.md
+    ├── qa.md
+    └── scribe.md
+```
+
+### Session Format (JSONL):
+
+One JSON object per line, append-only:
+
+```jsonl
+{"ts":"2025-10-05T14:30:00Z","type":"feature_add","name":"auth","tasks":5,"impact":"high","effort":"6h"}
+{"ts":"2025-10-05T15:00:00Z","type":"task_start","task":"JWT middleware","agent":"be","estimate":"2h"}
+{"ts":"2025-10-05T17:15:00Z","type":"task_complete","task":"JWT middleware","duration":"2h15m"}
+{"ts":"2025-10-05T18:00:00Z","type":"feature_ship","name":"auth","tasks_done":5,"total_time":"6h"}
+```
+
+## 🤖 Git Commit Format
+
+**ALL commits made by prjct MUST use this footer:**
+
+```
+🤖 Generated with [p/](https://www.prjct.app/)
+Designed for [Claude](https://www.anthropic.com/claude)
+```
+
+**Never use:**
+- ❌ "Generated with Claude Code"
+- ❌ "Co-Authored-By: Claude"
+
+**Always use:**
+- ✅ The prjct footer format above
+
+## 👤 Author Detection
+
+All operations include author information. Detection order:
+
+1. **GitHub CLI**: `gh api user` (preferred)
+   - Provides: name, email, username, avatarUrl
+2. **Git Config**: Fallback if GitHub CLI not available
+   - `git config user.name`
+   - `git config user.email`
+3. **Default**: If both fail
+   - name: "Unknown"
+   - email: "unknown@localhost"
+
+Every log entry in `memory/context.jsonl` includes author field.
+
+## ⚠️ Common Validation Patterns
+
+### Before Executing /p:done:
+```javascript
+// Check if there's an active task
+const nowContent = await Read('~/.prjct-cli/projects/{projectId}/core/now.md')
+if (!nowContent || nowContent.trim() === '') {
+  return "Not working on anything. Use /p:now to start a task."
+}
+```
+
+### Before Executing /p:ship:
+```javascript
+// Check if there's something to ship
+const shippedContent = await Read('~/.prjct-cli/projects/{projectId}/progress/shipped.md')
+const nowContent = await Read('~/.prjct-cli/projects/{projectId}/core/now.md')
+if ((!nowContent || nowContent.trim() === '') &&
+    (!shippedContent || shippedContent.trim() === '')) {
+  return "Nothing to ship yet. Build something first with /p:now."
+}
+```
+
+### Reading Project Config:
+```javascript
+// Always read config first
+const configPath = '.prjct/prjct.config.json'
+const configContent = await Read(configPath)
+const config = JSON.parse(configContent)
+const projectId = config.projectId
+const basePath = `~/.prjct-cli/projects/${projectId}/`
+```
+
+## 🔧 Error Handling
+
+### File Not Found:
+- If `core/now.md` doesn't exist when reading → return empty state
+- If `core/next.md` doesn't exist → return "No tasks in queue"
+- Always check file existence before operations
+
+### Invalid JSON:
+- If config file is corrupted → suggest running `/p:init` again
+- Log error to `memory/context.jsonl` for debugging
+
+### Permission Issues:
+- If can't write to `~/.prjct-cli/` → check directory permissions
+- Suggest: `chmod -R u+w ~/.prjct-cli/`
+
+## 📊 Performance Guidelines
+
+### Archive Rules:
+- Index files (roadmap.md, shipped.md) keep only last 30 days
+- Sessions older than 30 days → automatically moved to archive/
+- When querying across time: read relevant session files from archive/
+- Commands only read current index + today's session for performance
+
+### File Size Limits:
+- `core/now.md`: Single task only (< 1KB)
+- `core/next.md`: Max 100 tasks (< 50KB)
+- `progress/shipped.md`: Last 30 days only (auto-archive older)
+- Session files: One file per day, JSONL format for efficient appending
+
+## 🎯 Command Execution Flow
+
+Standard pattern for all `/p:*` commands:
+
+1. **Validate environment**: Check `.prjct/prjct.config.json` exists
+2. **Read config**: Extract projectId
+3. **Construct paths**: Build all file paths using base path
+4. **Execute operations**: Read/write files in global storage
+5. **Log action**: Append to `memory/context.jsonl` with timestamp and author
+6. **Return response**: Formatted response with next action suggestions
+
+## 📚 Additional Context
+
+- **Website**: https://prjct.app
+- **Documentation**: https://prjct.app/docs
+- **Repository**: Private (proprietary software)
+- **Support**: jlopezlira@gmail.com
+- **Version**: Auto-updated with prjct-cli
+
+---
+
+**Last updated**: Auto-managed by prjct-cli
+**Config version**: 0.8.2
+
+<!-- prjct:end - DO NOT REMOVE THIS MARKER -->