prjct-cli 0.4.5 → 0.4.6

package/CHANGELOG.md

@@ -15,7 +15,35 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Cross-platform file operations
   - Windows Terminal integration
 
-## [0.4.5] - 2025-10-02
+## [0.4.6] - 2025-10-02
+
+### Added
+- **`prjct start` Command** - First-time setup with interactive editor selection
+  - Beautiful ASCII art welcome message
+  - Auto-detects installed AI editors (Claude Code, Cursor, Windsurf)
+  - Interactive prompt to choose which editors to install commands to
+  - Replaces confusing `prjct install` command with clearer naming
+  - Only runs once (blocks if already configured, suggests `prjct setup` to reconfigure)
+
+- **Auto-Initialization** - Commands auto-run `prjct init` when needed
+  - All core commands (now, done, ship, next, idea, recap, stuck, context) check initialization
+  - Shows warning and runs init automatically if project not configured
+  - Zero friction - users don't need to remember to run init first
+  - Seamless workflow: `cd project/ && prjct now "task"` just works
+
+### Changed
+- **Simplified Installation Flow**
+  - `npm install -g prjct-cli` → Shows welcome message, tells user to run `prjct start`
+  - `prjct start` → Interactive setup (first-time only)
+  - `prjct init` → Initialize project (links to global data)
+  - `prjct setup` → Reconfigure editors (replaces old `prjct install`)
+  - `npm update -g prjct-cli` → Auto-updates commands in tracked editors
+
+- **Post-Install Behavior**
+  - Removed auto-installation on npm install (was non-interactive and confusing)
+  - First install shows: `Run: prjct start to get started`
+  - Updates auto-update commands in previously selected editors
+  - Cleaner, more predictable behavior
 
 ### Fixed
 - **Critical Bug Fixes** - All commands now enforce global architecture correctly
@@ -28,10 +56,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - **Added 'Apps' directory** to migration scanner for better project detection
 
 ### Technical Details
+- **New Commands**:
+  - `start()` - First-time setup with ASCII art and interactive editor selection
+  - `setup()` - Renamed from `install()` for clarity
+  - `ensureProjectInit()` - Helper function for auto-initialization
 - **Global Architecture**: All commands now use `pathManager.getGlobalProjectPath(projectId)`
   - design(), cleanup(), getDaysSinceLastShip() fully migrated
   - Prevents LOCAL .prjct/ creation
   - Requires project initialization before command execution
+- **Auto-Init Integration**: now(), done(), ship(), next(), idea(), recap(), stuck(), context() all auto-initialize
 - **Migration Enhancement**: Added ~/Apps to common directories scan
 - **Post-Install Fix**: currentVersion variable properly declared at function start
 

package/bin/prjct

@@ -8,6 +8,9 @@ async function main() {
 
     let result;
     switch(command) {
+        case 'start':
+            result = await commands.start();
+            break;
         case 'init':
             result = await commands.init();
             break;
@@ -107,23 +110,23 @@ async function main() {
 
             result = await commands.migrateAll(migrateOptions);
             break;
-        case 'install':
-            const installOptions = {};
-            const installArgs = args.slice(1);
-
-            for (let i = 0; i < installArgs.length; i++) {
-                if (installArgs[i] === '--force') {
-                    installOptions.force = true;
-                } else if (installArgs[i] === '--editor') {
-                    installOptions.editor = installArgs[++i];
-                } else if (installArgs[i] === '--create-templates') {
-                    installOptions.createTemplates = true;
-                } else if (installArgs[i] === '--no-interactive') {
-                    installOptions.interactive = false;
+        case 'setup':
+            const setupOptions = {};
+            const setupArgs = args.slice(1);
+
+            for (let i = 0; i < setupArgs.length; i++) {
+                if (setupArgs[i] === '--force') {
+                    setupOptions.force = true;
+                } else if (setupArgs[i] === '--editor') {
+                    setupOptions.editor = setupArgs[++i];
+                } else if (setupArgs[i] === '--create-templates') {
+                    setupOptions.createTemplates = true;
+                } else if (setupArgs[i] === '--no-interactive') {
+                    setupOptions.interactive = false;
                 }
             }
 
-            result = await commands.install(installOptions);
+            result = await commands.setup(setupOptions);
             break;
         case 'analyze':
             const analyzeOptions = {};
@@ -155,6 +158,10 @@ async function main() {
             result = {
                 success: true,
                 message: `Available commands:
+  Setup:
+    start             First-time setup (install commands to editors)
+    setup             Reconfigure editor installations
+
   Core workflow:
     init              Initialize prjct in current project
     now [task]        Set or show current task
@@ -173,9 +180,8 @@ async function main() {
     design [target]   Design system/architecture
     analyze           Analyze codebase and sync state
     migrate-all       Migrate all legacy projects
-    install           Install commands to AI editors
 
-  Install options:
+  Setup options:
     --force           Force update existing commands
     --editor <name>   Install to specific editor (claude|cursor|codex|windsurf)
     --no-interactive  Skip interactive selection, install to all
@@ -188,6 +194,10 @@ async function main() {
                 message: `Unknown command: ${command}
 
 Available commands:
+  Setup:
+    start             First-time setup (install commands to editors)
+    setup             Reconfigure editor installations
+
   Core workflow:
     init              Initialize prjct in current project
     now [task]        Set or show current task
@@ -206,9 +216,8 @@ Available commands:
     design [target]   Design system/architecture
     analyze           Analyze codebase and sync state
     migrate-all       Migrate all legacy projects
-    install           Install commands to AI editors
 
-  Install options:
+  Setup options:
     --force           Force update existing commands
     --editor <name>   Install to specific editor (claude|cursor|codex|windsurf)
     --no-interactive  Skip interactive selection, install to all

package/core/commands.js

@@ -249,6 +249,31 @@ class PrjctCommands {
     return this.currentAuthor
   }
 
+  /**
+   * Auto-initialize project if not configured
+   * Shows warning and runs init automatically
+   *
+   * @param {string} projectPath - Local project path
+   * @returns {Promise<{success: boolean, message?: string}>} Success or init result
+   */
+  async ensureProjectInit(projectPath) {
+    if (await configManager.isConfigured(projectPath)) {
+      return { success: true }
+    }
+
+    const chalk = require('chalk')
+    console.log(chalk.yellow('⚠️  Project not initialized'))
+    console.log(chalk.cyan('🔧 Running prjct init...\n'))
+
+    const initResult = await this.init(projectPath)
+    if (!initResult.success) {
+      return initResult
+    }
+
+    console.log(chalk.green('✅ Project initialized!\n'))
+    return { success: true }
+  }
+
   /**
    * Get the global project path for a project
    * Ensures migration if needed
@@ -413,6 +438,12 @@ class PrjctCommands {
       await this.initializeAgent()
       await this.ensureAuthor()
 
+      // Auto-init if not configured
+      const initCheck = await this.ensureProjectInit(projectPath)
+      if (!initCheck.success) {
+        return initCheck
+      }
+
       const nowFile = await this.getFilePath(projectPath, 'core', 'now.md')
 
       if (!task) {
@@ -494,6 +525,13 @@ class PrjctCommands {
   async done(projectPath = process.cwd()) {
     try {
       await this.initializeAgent()
+
+      // Auto-init if not configured
+      const initCheck = await this.ensureProjectInit(projectPath)
+      if (!initCheck.success) {
+        return initCheck
+      }
+
       const nowFile = await this.getFilePath(projectPath, 'core', 'now.md')
       const nextFile = await this.getFilePath(projectPath, 'core', 'next.md')
 
@@ -655,6 +693,12 @@ ${nextStep.agent}
     try {
       await this.initializeAgent()
 
+      // Auto-init if not configured
+      const initCheck = await this.ensureProjectInit(projectPath)
+      if (!initCheck.success) {
+        return initCheck
+      }
+
       if (!feature) {
         return {
           success: false,
@@ -764,6 +808,13 @@ ${nextStep.agent}
   async next(projectPath = process.cwd()) {
     try {
       await this.initializeAgent()
+
+      // Auto-init if not configured
+      const initCheck = await this.ensureProjectInit(projectPath)
+      if (!initCheck.success) {
+        return initCheck
+      }
+
       const nextFile = await this.getFilePath(projectPath, 'core', 'next.md')
       const content = await this.agent.readFile(nextFile)
 
@@ -806,6 +857,12 @@ ${nextStep.agent}
     try {
       await this.initializeAgent()
 
+      // Auto-init if not configured
+      const initCheck = await this.ensureProjectInit(projectPath)
+      if (!initCheck.success) {
+        return initCheck
+      }
+
       if (!text) {
         return {
           success: false,
@@ -862,6 +919,12 @@ ${nextStep.agent}
     try {
       await this.initializeAgent()
 
+      // Auto-init if not configured
+      const initCheck = await this.ensureProjectInit(projectPath)
+      if (!initCheck.success) {
+        return initCheck
+      }
+
       const nowFilePath = await this.getFilePath(projectPath, 'core', 'now.md')
       const nextFilePath = await this.getFilePath(projectPath, 'core', 'next.md')
       const ideasFilePath = await this.getFilePath(projectPath, 'planning', 'ideas.md')
@@ -1100,6 +1163,12 @@ ${nextStep.agent}
     try {
       await this.initializeAgent()
 
+      // Auto-init if not configured
+      const initCheck = await this.ensureProjectInit(projectPath)
+      if (!initCheck.success) {
+        return initCheck
+      }
+
       if (!issue) {
         return {
           success: false,
@@ -1394,6 +1463,12 @@ ${diagram}
     try {
       await this.initializeAgent()
 
+      // Auto-init if not configured
+      const initCheck = await this.ensureProjectInit(projectPath)
+      if (!initCheck.success) {
+        return initCheck
+      }
+
       const projectInfo = await this.detectProjectType(projectPath)
 
       const nowFilePath = await this.getFilePath(projectPath, 'core', 'now.md')
@@ -1866,12 +1941,109 @@ ${diagram}
   }
 
   /**
-   * Install commands to AI editors
+   * First-time setup - Install commands to AI editors with ASCII art welcome
+   *
+   * @returns {Promise<Object>} Result object with success flag and message
+   */
+  async start() {
+    try {
+      await this.initializeAgent()
+
+      // Check if already configured
+      const editorsConfig = require('./editors-config')
+      const configExists = await editorsConfig.configExists()
+
+      if (configExists) {
+        return {
+          success: false,
+          message: this.agent.formatResponse(
+            'prjct is already set up!\n\nTo reconfigure editors: prjct setup',
+            'warning'
+          ),
+        }
+      }
+
+      // ASCII Art
+      const chalk = require('chalk')
+      console.log(
+        chalk.cyan(`
+   ___  ____    _ ____ _____
+  / _ \\|  _ \\  | / ___|_   _|
+ | |_| | |_) |_| | |     | |
+ |  __/|  _ <| | | |___  | |
+ | |   | |_) | | |\\____| | |
+ |_|   |____/|_| |       |_|
+    `)
+      )
+
+      console.log(chalk.cyan('\n📦 Welcome to prjct-cli!\n'))
+
+      // Detect editors
+      const commandInstaller = require('./command-installer')
+      const detection = await commandInstaller.detectEditors()
+      const detectedEditors = Object.entries(detection).filter(([_, info]) => info.detected)
+
+      if (detectedEditors.length === 0) {
+        return {
+          success: false,
+          message: this.agent.formatResponse(
+            'No AI editors detected.\n\nSupported: Claude Code, Cursor, Windsurf',
+            'error'
+          ),
+        }
+      }
+
+      console.log(chalk.cyan('🔍 Detected AI editors:'))
+      detectedEditors.forEach(([key, info]) => {
+        console.log(chalk.green(`  [✓] ${info.name} (${info.path})`))
+      })
+      console.log('')
+
+      // Interactive selection
+      const installResult = await commandInstaller.interactiveInstall(false)
+
+      if (!installResult.success) {
+        return {
+          success: false,
+          message: this.agent.formatResponse(installResult.message || 'Setup failed', 'error'),
+        }
+      }
+
+      // Install Context7 MCP
+      const mcpResult = await commandInstaller.installContext7MCP()
+
+      // Success message
+      let message = `✅ Commands installed in: ${installResult.editors.join(', ')}\n`
+
+      if (mcpResult.success && mcpResult.editors.length > 0) {
+        message += `\n🔌 Context7 MCP enabled in: ${mcpResult.editors.join(', ')}`
+      }
+
+      message += '\n\n✨ prjct is ready to use!'
+      message += '\n\nNext steps:'
+      message += '\n  cd your-project/'
+      message += '\n  prjct init'
+
+      return {
+        success: true,
+        message: this.agent.formatResponse(message, 'celebrate'),
+      }
+    } catch (error) {
+      await this.initializeAgent()
+      return {
+        success: false,
+        message: this.agent.formatResponse(`Setup failed: ${error.message}`, 'error'),
+      }
+    }
+  }
+
+  /**
+   * Setup/reconfigure commands in AI editors
    *
    * @param {Object} [options={}] - Installation options
    * @returns {Promise<Object>} Result object with success flag and message
    */
-  async install(options = {}) {
+  async setup(options = {}) {
     try {
       await this.initializeAgent()
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prjct-cli",
-  "version": "0.4.5",
+  "version": "0.4.6",
   "description": "AI-integrated project management for indie hackers - works with Claude Code, Cursor, and Warp",
   "main": "core/index.js",
   "bin": {

package/scripts/post-install.js

@@ -21,7 +21,7 @@ const { execSync } = require('child_process')
 
 async function main() {
   try {
-    // Get current package version (needed by multiple code paths)
+    // Get current package version
     const packageJson = require('../package.json')
     const currentVersion = packageJson.version
 
@@ -41,41 +41,9 @@ async function main() {
     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`))
-      } else {
-        console.log(chalk.yellow('⚠️  Some editors could not be configured'))
-        if (process.env.DEBUG) {
-          console.log(chalk.gray(`   Error: ${results.message || 'Unknown error'}`))
-        }
-      }
-
+      // First-time install - show welcome message
+      console.log(chalk.cyan('\n✨ prjct-cli installed successfully!\n'))
+      console.log(chalk.gray('Run: ') + chalk.cyan('prjct start') + chalk.gray(' to get started\n'))
       return
     }
 
@@ -87,9 +55,8 @@ async function main() {
       return
     }
 
-    // Get tracked editors and paths
+    // Get tracked editors
     const trackedEditors = await editorsConfig.getTrackedEditors()
-    const editorPaths = await editorsConfig.getEditorPaths()
 
     if (trackedEditors.length === 0) {
       // No editors tracked yet