proagents 1.6.12 → 1.6.15

package/.proagents/worklog/_context.md

@@ -8,6 +8,36 @@ Last AI: [None]
 
 ---
 
+## Quick Summary
+<!-- AI auto-generates this section - always keep under 5 lines -->
+```
+Last: [None yet]
+Active: No active features
+Pending: 0 tasks
+Tests: Unknown
+Status: Ready for work
+```
+
+---
+
+## Test Status
+<!-- AI updates after running tests -->
+```
+Status: Unknown
+Last Run: Never
+Failing: None
+```
+
+---
+
+## Feature Progress
+<!-- AI auto-calculates from completed vs pending tasks -->
+```
+No active features
+```
+
+---
+
 ## Active Work
 
 No active features yet. Start with `pa:feature "name"` or `pa:fix "issue"`.
@@ -38,6 +68,6 @@ None.
 
 ## How to Use
 
-1. **Starting work:** Run `pa:sync` to load this context
+1. **Starting work:** Context loads automatically on first pa: command
 2. **After code changes:** AI auto-updates this file
 3. **Check history:** See `./worklog/` for detailed session logs

package/.proagents/worklog/_context.template.md

@@ -0,0 +1,82 @@
+# Current Project Context - Template Reference
+
+> This is the FORMAT REFERENCE for `_context.md`.
+> AI should read this template when creating/updating `_context.md`.
+> DO NOT modify this file - it gets updated with ProAgents upgrades.
+
+---
+
+## Expected Structure
+
+```markdown
+# Current Project Context
+
+> **For AI Assistants:** Read this file first to understand current state.
+> **Auto-updated** after each code change.
+
+Last Updated: [ISO timestamp]
+Last AI: [Platform (model)]
+
+---
+
+## Quick Summary
+<!-- AI auto-generates - keep under 5 lines -->
+```
+Last: [Last action]
+Active: [Feature name or "No active features"]
+Pending: [N] tasks
+Tests: [Passing/Failing/Unknown]
+Status: [Current status]
+```
+
+---
+
+## Test Status
+<!-- AI updates after running tests -->
+```
+Status: [Passing/Failing/Unknown]
+Last Run: [Timestamp]
+Failing: [Test names or "None"]
+```
+
+---
+
+## Feature Progress
+<!-- AI auto-calculates -->
+```
+[Feature name]: [X]% ([done]/[total] tasks)
+```
+
+---
+
+## Active Work
+[Current active features or tasks]
+
+---
+
+## Recent Changes
+[Last 3-5 changes]
+
+---
+
+## Pending Items
+[Outstanding tasks]
+
+---
+
+## Quick Stats
+| Metric | Value |
+|--------|-------|
+| Active Features | [N] |
+| Completed Today | [N] |
+| Open Issues | [N] |
+```
+
+## Auto-Update Rules
+
+1. **Update `Last Updated`** with current timestamp
+2. **Update `Last AI`** with current platform
+3. **Keep Quick Summary under 5 lines**
+4. **Update Test Status after test runs**
+5. **Update Recent Changes with last 3-5 items**
+6. **Calculate Feature Progress from active-features/**

package/.proagents/worklog/ai-stats.json

@@ -0,0 +1,19 @@
+{
+  "ai_platforms": {},
+  "totals": {
+    "total_sessions": 0,
+    "total_tasks": 0,
+    "total_files_modified": 0,
+    "total_reverts": 0
+  },
+  "_format": {
+    "platform_entry": {
+      "sessions": 0,
+      "tasks_completed": 0,
+      "files_modified": 0,
+      "reverts": 0,
+      "avg_session_minutes": 0,
+      "last_session": null
+    }
+  }
+}

package/.proagents/worklog/ai-stats.template.json

@@ -0,0 +1,54 @@
+{
+  "_template_info": {
+    "description": "Template reference for ai-stats.json schema",
+    "note": "DO NOT modify this file - it gets updated with ProAgents upgrades",
+    "usage": "AI reads this to understand expected schema for ai-stats.json"
+  },
+
+  "ai_platforms": {
+    "claude": {
+      "sessions": 0,
+      "tasks_completed": 0,
+      "files_modified": 0,
+      "reverts": 0,
+      "avg_session_minutes": 0,
+      "last_session": "2024-03-13T10:30:00Z"
+    },
+    "chatgpt": {
+      "sessions": 0,
+      "tasks_completed": 0,
+      "files_modified": 0,
+      "reverts": 0,
+      "avg_session_minutes": 0,
+      "last_session": null
+    }
+  },
+
+  "totals": {
+    "total_sessions": 0,
+    "total_tasks": 0,
+    "total_files_modified": 0,
+    "total_reverts": 0
+  },
+
+  "_schema": {
+    "ai_platforms": {
+      "type": "object",
+      "description": "Stats per AI platform",
+      "properties": {
+        "[platform_id]": {
+          "sessions": "number - Total sessions by this AI",
+          "tasks_completed": "number - Tasks completed",
+          "files_modified": "number - Files modified",
+          "reverts": "number - Changes reverted by user",
+          "avg_session_minutes": "number - Average session duration",
+          "last_session": "string|null - ISO timestamp of last session"
+        }
+      }
+    },
+    "totals": {
+      "type": "object",
+      "description": "Aggregated totals across all AIs"
+    }
+  }
+}

package/README.md

@@ -86,6 +86,13 @@ Multiple AIs can work on the same project with full context sharing:
 | **Module Changelogs** | Per-module change history |
 | **Conflict Detection** | Warns if files modified by other AI |
 | **Activity Log** | Track what each AI does with model name |
+| **Smart Context Summary** | Auto-generated 5-line summary at top of context |
+| **Context Changed Alert** | Warns if another AI worked since your last session |
+| **Test Status Tracking** | Auto-updates test status after every test run |
+| **Feature Progress** | Auto-calculates progress from tasks |
+| **AI Performance Stats** | Tracks sessions, tasks, reverts per AI platform |
+| **Quick Undo (pa:undo-last)** | Revert last AI's entire session changes |
+| **Auto-Archive Old Logs** | Automatically archives logs older than 7 days |
 
 ```bash
 # Just start working - context loads automatically!
@@ -94,6 +101,9 @@ pa:fix "bug in auth"      # AI auto-loads context, then fixes
 
 # No manual pa:sync needed - it's automatic
 # No manual pa:session-end needed - changes logged automatically
+
+# Undo another AI's work if needed
+pa:undo-last              # Revert last AI's entire session
 ```
 
 ### Project Templates
@@ -157,8 +167,30 @@ proagents fix "bug description"       # Quick bug fix mode
 
 # Maintenance
 proagents doctor                      # Health check installation
-proagents upgrade                     # Upgrade to latest version
+proagents doctor --full               # Extended checks (branches, logs, features)
 proagents status                      # Show ProAgents status
+proagents version                     # Show detailed version info
+
+# Release Notes
+proagents release                     # Interactive release note generator
+proagents release -t detailed         # Full comprehensive notes
+proagents release -t short            # Quick summary
+proagents release -t client           # Business-focused, non-technical
+proagents release -t developer        # Technical details for devs
+proagents release -t hotfix           # Urgent patch notes
+proagents release -t prerelease       # Beta/RC notes
+proagents release --include fixes     # Only include bug fixes
+proagents release --include features  # Only include features
+proagents release --append -o FILE    # Append to existing notes
+proagents release --bump              # Suggest version bump
+proagents release --module auth       # Filter by module name
+proagents release --changelog         # Update CHANGELOG.md
+proagents release --tag               # Create git tag
+proagents release --json              # JSON output for CI/CD
+
+# Updating ProAgents
+npx proagents init                    # Smart update (recommended)
+proagents upgrade                     # Full replace (use with caution)
 
 # AI Platforms
 proagents ai list                     # List installed AI platforms
@@ -168,6 +200,34 @@ proagents ai remove                   # Remove platforms
 # Configuration
 proagents config show                 # Show current config
 proagents config setup                # Interactive config wizard
+proagents config export               # Export config for sharing
+proagents config import <file>        # Import config from file
+
+# Statistics & Monitoring
+proagents stats                       # Show project & AI usage stats
+proagents stats --json                # JSON output for scripting
+
+# Changelog Management
+proagents changelog view              # View recent changelog entries
+proagents changelog add "entry"       # Add new changelog entry
+proagents changelog list              # List available changelogs
+proagents changelog export            # Export to CHANGELOG.md
+proagents changelog git               # View git history as changelog
+
+# Backup & Restore
+proagents restore <backup.json>       # Restore from uninstall backup
+
+# Shell Completions
+proagents completion bash             # Generate bash completions
+proagents completion zsh              # Generate zsh completions
+proagents completion fish             # Generate fish completions
+
+# Quick File Access
+proagents open                        # Show available shortcuts
+proagents open config                 # Open proagents.config.yaml
+proagents open changelog              # Open recent changelog
+proagents open activity               # Open activity log
+proagents open context                # Open worklog context
 
 # Other
 proagents docs                        # Open documentation
@@ -175,6 +235,27 @@ proagents commands                    # Show all commands
 proagents uninstall                   # Remove ProAgents
 ```
 
+### Updating ProAgents
+
+| Command | What It Does | When to Use |
+|---------|--------------|-------------|
+| `npx proagents init` | **Smart update** - Updates 60 framework folders, merges config, preserves your work | **Recommended** for regular updates |
+| `proagents upgrade` | **Full replace** - Removes everything, installs fresh, restores backups | Only when you need a complete reset |
+
+**What's preserved with `init` (smart update):**
+- `active-features/` - Your work in progress
+- `changelog/` - Your change history (_recent.md, modules/, features/)
+- `worklog/` - Your work context (_context.md, ai-stats.json)
+- `.learning/` - Learned patterns
+- `cache/` - Analysis cache
+- `proagents.config.yaml` - Your values kept, new options merged
+
+**What's preserved with `upgrade` (full replace):**
+- `proagents.config.yaml`, `activity.log`, `handoff.md`, `.lock`
+- `active-features/` - All files
+- `changelog/` - _recent.md, modules/, features/, yearly folders
+- `worklog/` - _context.md, ai-stats.json
+
 ---
 
 ## AI Commands (pa:)
@@ -240,6 +321,8 @@ Type these in any AI assistant (Claude, ChatGPT, Gemini, Cursor, etc.):
 | `pa:session-start` | Begin new work session |
 | `pa:session-end` | Finalize session, update logs |
 | `pa:conflict-check` | Check if files modified by other AI |
+| `pa:undo-last` | Undo last AI's entire session (revert all changes) |
+| `pa:undo-file "path"` | Undo changes to specific file |
 | `pa:changelog` | Update all changelogs |
 | `pa:changelog --from-git` | Auto-populate from git commits |
 | `pa:changelog-feature X` | View feature changelog |
@@ -529,6 +612,7 @@ your-project/
 │   ├── custom-commands.yaml    # Custom pa: commands
 │   ├── worklog/                # Cross-AI session tracking
 │   │   ├── _context.md         # Quick context for any AI
+│   │   ├── ai-stats.json       # AI performance stats
 │   │   └── YYYY-MM-DD-ai-*.md  # Session logs
 │   ├── changelog/              # Detailed changelogs
 │   │   ├── _recent.md          # Last 10 changes

package/bin/proagents.js

@@ -8,10 +8,17 @@ import { statusCommand } from '../lib/commands/status.js';
 import { helpCommand } from '../lib/commands/help.js';
 import { aiAddCommand, aiListCommand, aiRemoveCommand } from '../lib/commands/ai.js';
 import { uninstallCommand } from '../lib/commands/uninstall.js';
-import { configListCommand, configShowCommand, configEditCommand, configSetCommand, configGetCommand, configSetupCommand, configCustomizeCommand } from '../lib/commands/config.js';
+import { configListCommand, configShowCommand, configEditCommand, configSetCommand, configGetCommand, configSetupCommand, configCustomizeCommand, configExportCommand, configImportCommand } from '../lib/commands/config.js';
 import { doctorCommand } from '../lib/commands/doctor.js';
 import { upgradeCommand } from '../lib/commands/upgrade.js';
 import { migrateCommand } from '../lib/commands/migrate.js';
+import { versionCommand } from '../lib/commands/version.js';
+import { releaseCommand } from '../lib/commands/release.js';
+import { statsCommand } from '../lib/commands/stats.js';
+import { restoreCommand } from '../lib/commands/restore.js';
+import { changelogCommand, changelogAddCommand, changelogListCommand, changelogExportCommand, changelogViewCommand } from '../lib/commands/changelog.js';
+import { completionCommand } from '../lib/commands/completion.js';
+import { openCommand } from '../lib/commands/open.js';
 import { readFileSync } from 'fs';
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
@@ -149,6 +156,20 @@ config
   .description('Copy templates to create custom configurations')
   .action(configCustomizeCommand);
 
+config
+  .command('export')
+  .description('Export configuration for sharing or backup')
+  .option('-o, --output [path]', 'Output to file instead of stdout')
+  .action(configExportCommand);
+
+config
+  .command('import <file>')
+  .description('Import configuration from export file')
+  .option('-f, --force', 'Skip confirmation prompt')
+  .option('-q, --quiet', 'Minimal output')
+  .option('--json', 'Output in JSON format')
+  .action(configImportCommand);
+
 // Uninstall command
 program
   .command('uninstall')
@@ -166,6 +187,7 @@ program
 program
   .command('doctor')
   .description('Check health of ProAgents installation')
+  .option('--full', 'Run extended health checks')
   .action(doctorCommand);
 
 // Upgrade command
@@ -182,4 +204,113 @@ program
   .option('-f, --force', 'Skip confirmation prompt')
   .action(migrateCommand);
 
+// Version command (detailed)
+program
+  .command('version')
+  .description('Show detailed version information')
+  .option('--offline', 'Skip checking npm for latest version')
+  .action(versionCommand);
+
+// Stats command
+program
+  .command('stats')
+  .description('Show project and AI usage statistics')
+  .option('--json', 'Output in JSON format')
+  .action(statsCommand);
+
+// Restore command
+program
+  .command('restore <backup-file>')
+  .description('Restore ProAgents data from backup')
+  .option('-f, --force', 'Skip confirmation prompt')
+  .option('-q, --quiet', 'Minimal output')
+  .option('--json', 'Output in JSON format')
+  .action(restoreCommand);
+
+// Changelog commands
+const changelog = program
+  .command('changelog')
+  .description('Manage project changelogs');
+
+changelog
+  .command('view')
+  .description('View recent changelog entries (default)')
+  .option('-l, --limit <number>', 'Number of entries to show', '10')
+  .option('--json', 'Output in JSON format')
+  .action(changelogViewCommand);
+
+changelog
+  .command('add <entry>')
+  .description('Add a new changelog entry')
+  .option('--json', 'Output in JSON format')
+  .action(changelogAddCommand);
+
+changelog
+  .command('list')
+  .description('List available changelogs (features, modules, years)')
+  .option('--json', 'Output in JSON format')
+  .action(changelogListCommand);
+
+changelog
+  .command('export')
+  .description('Export changelog to CHANGELOG.md')
+  .option('--git', 'Include git commit history')
+  .option('--json', 'Output in JSON format')
+  .action(changelogExportCommand);
+
+changelog
+  .command('feature <name>')
+  .description('View changelog for a specific feature')
+  .action((name) => changelogCommand('feature', name));
+
+changelog
+  .command('module <name>')
+  .description('View changelog for a specific module')
+  .action((name) => changelogCommand('module', name));
+
+changelog
+  .command('git')
+  .description('View git commit history as changelog')
+  .option('--since <ref>', 'Start from tag/commit/date')
+  .option('--until <ref>', 'End at tag/commit/date')
+  .option('-l, --limit <number>', 'Number of commits', '20')
+  .action((options) => changelogCommand('git', null, options));
+
+// Release command
+program
+  .command('release')
+  .description('Generate release notes with type selection')
+  .option('-t, --type <type>', 'Release type: detailed, short, client, developer, hotfix, prerelease')
+  .option('-v, --version <version>', 'Version number (defaults to package.json)')
+  .option('-o, --output [path]', 'Output to file (optional path)')
+  .option('-a, --append', 'Append to existing release notes file')
+  .option('-i, --include <categories>', 'Include only: features,fixes,improvements,security,breaking,docs,deps,perf')
+  .option('-e, --exclude <categories>', 'Exclude categories (comma-separated)')
+  .option('-m, --module <name>', 'Filter by module/component name in commits')
+  .option('-p, --path <path>', 'Filter commits by file path')
+  .option('--since <ref>', 'Start from tag/commit/date')
+  .option('--until <ref>', 'End at tag/commit/date')
+  .option('--bump', 'Suggest version bump based on changes')
+  .option('--prerelease <stage>', 'Mark as pre-release (beta, rc, alpha)')
+  .option('--urgency <level>', 'Hotfix urgency level (low, medium, high, critical)')
+  .option('--interactive', 'Interactive mode with filter selection')
+  .option('--changelog', 'Update CHANGELOG.md with release notes')
+  .option('--tag', 'Create git tag for this release')
+  .option('--tag-message <message>', 'Custom message for git tag')
+  .option('--json', 'Output in JSON format (for scripting)')
+  .action(releaseCommand);
+
+// Completion command
+program
+  .command('completion [shell]')
+  .description('Generate shell completion scripts (bash, zsh, fish)')
+  .option('-q, --quiet', 'Skip install instructions')
+  .action(completionCommand);
+
+// Open command
+program
+  .command('open [target]')
+  .description('Open ProAgents files quickly (config, changelog, activity, etc.)')
+  .action(openCommand);
+
 program.parse();

package/lib/commands/ai.js

@@ -24,13 +24,19 @@ export const AI_PLATFORMS = {
   web: {
     label: 'Web-based AI Platforms',
     platforms: [
-      { id: 'chatgpt', name: 'ChatGPT / Codex', file: 'CHATGPT.md', desc: 'OpenAI ChatGPT' },
+      { id: 'chatgpt', name: 'ChatGPT', file: 'CHATGPT.md', desc: 'OpenAI ChatGPT' },
       { id: 'gemini', name: 'Gemini', file: 'GEMINI.md', desc: 'Google Gemini' },
       { id: 'replit', name: 'Replit AI', file: 'REPLIT.md', desc: 'Replit Ghostwriter' },
       { id: 'bolt', name: 'Bolt.new', file: 'BOLT.md', desc: 'StackBlitz Bolt' },
       { id: 'lovable', name: 'Lovable', file: 'LOVABLE.md', desc: 'Lovable (GPT Engineer)' },
       { id: 'groq', name: 'Groq', file: 'GROQ.md', desc: 'Groq fast inference' },
     ]
+  },
+  cli: {
+    label: 'CLI-based AI Agents',
+    platforms: [
+      { id: 'codex', name: 'Codex CLI', file: 'AGENTS.md', desc: 'OpenAI Codex CLI' },
+    ]
   }
 };
 
@@ -39,6 +45,7 @@ export function getAllPlatforms() {
   return [
     ...AI_PLATFORMS.ide.platforms,
     ...AI_PLATFORMS.web.platforms,
+    ...AI_PLATFORMS.cli.platforms,
   ];
 }
 
@@ -47,6 +54,39 @@ export function getPlatformById(id) {
   return getAllPlatforms().find(p => p.id === id);
 }
 
+/**
+ * Detect current IDE from environment variables
+ * Returns platform ID if detected and it's in our AI_PLATFORMS config, null otherwise
+ * Note: VS Code is NOT an AI platform, so we skip it even if detected
+ */
+export function detectIDE() {
+  // Cursor IDE - check for Cursor-specific env vars
+  if (process.env.CURSOR_TRACE_ID || process.env.CURSOR_CHANNEL || process.env.CURSOR_SESSION_ID) {
+    return 'cursor';
+  }
+
+  // Windsurf IDE - Codeium's IDE
+  if (process.env.WINDSURF_SESSION_ID || process.env.CODEIUM_API_KEY ||
+      (process.env.TERM_PROGRAM && process.env.TERM_PROGRAM.toLowerCase().includes('windsurf'))) {
+    return 'windsurf';
+  }
+
+  // AWS Kiro IDE
+  if (process.env.KIRO_SESSION || process.env.KIRO_API_KEY ||
+      (process.env.TERM_PROGRAM && process.env.TERM_PROGRAM.toLowerCase().includes('kiro'))) {
+    return 'kiro';
+  }
+
+  // VS Code - NOT an AI platform, explicitly return null
+  // This prevents accidental detection as we don't want to create files for plain VS Code
+  if (process.env.TERM_PROGRAM === 'vscode' || process.env.VSCODE_GIT_IPC_HANDLE) {
+    return null;
+  }
+
+  // No AI-powered IDE detected
+  return null;
+}
+
 /**
  * Interactive platform selection using readline
  * @param {string[]} previouslySelected - Previously selected platforms (from interrupted setup)
@@ -59,6 +99,21 @@ export async function selectPlatforms(previouslySelected = []) {
 
   const question = (prompt) => new Promise(resolve => rl.question(prompt, resolve));
 
+  // Auto-detect IDE and pre-select it
+  const detectedIDE = detectIDE();
+  let autoSelected = [];
+
+  if (detectedIDE) {
+    const platform = getPlatformById(detectedIDE);
+    if (platform) {
+      console.log(chalk.green(`\n✓ Detected ${platform.name} IDE - auto-selected`));
+      autoSelected = [detectedIDE];
+    }
+  }
+
+  // Merge auto-detected with previously selected
+  const preselected = [...new Set([...autoSelected, ...(previouslySelected || [])])];
+
   console.log('\n' + chalk.bold('Which AI platform(s) do you use?'));
   console.log(chalk.gray('(Enter numbers separated by commas, or "all" for all platforms)\n'));
 
@@ -69,11 +124,18 @@ export async function selectPlatforms(previouslySelected = []) {
   // IDE-based platforms
   console.log(chalk.cyan.bold(`  ${AI_PLATFORMS.ide.label}:`));
   for (const platform of AI_PLATFORMS.ide.platforms) {
-    const wasSelected = previouslySelected && previouslySelected.includes(platform.id);
-    const marker = wasSelected ? chalk.green(' ✓ (previously selected)') : '';
+    const isAutoDetected = autoSelected.includes(platform.id);
+    const wasPreviouslySelected = previouslySelected && previouslySelected.includes(platform.id);
+    const isPreselected = preselected.includes(platform.id);
+    let marker = '';
+    if (isAutoDetected) {
+      marker = chalk.green(' ✓ (auto-detected)');
+    } else if (wasPreviouslySelected) {
+      marker = chalk.green(' ✓ (previously selected)');
+    }
     console.log(chalk.white(`    ${index}. ${platform.name}`) + chalk.gray(` - ${platform.desc}`) + marker);
     indexMap[index] = platform.id;
-    if (wasSelected) preSelectedIndices.push(index);
+    if (isPreselected) preSelectedIndices.push(index);
     index++;
   }
 
@@ -82,27 +144,42 @@ export async function selectPlatforms(previouslySelected = []) {
   // Web-based platforms
   console.log(chalk.cyan.bold(`  ${AI_PLATFORMS.web.label}:`));
   for (const platform of AI_PLATFORMS.web.platforms) {
-    const wasSelected = previouslySelected && previouslySelected.includes(platform.id);
-    const marker = wasSelected ? chalk.green(' ✓ (previously selected)') : '';
+    const wasPreviouslySelected = previouslySelected && previouslySelected.includes(platform.id);
+    const isPreselected = preselected.includes(platform.id);
+    const marker = wasPreviouslySelected ? chalk.green(' ✓ (previously selected)') : '';
     console.log(chalk.white(`    ${index}. ${platform.name}`) + chalk.gray(` - ${platform.desc}`) + marker);
     indexMap[index] = platform.id;
-    if (wasSelected) preSelectedIndices.push(index);
+    if (isPreselected) preSelectedIndices.push(index);
     index++;
   }
 
   console.log('');
 
-  // Show default based on previous selection
+  // CLI-based platforms
+  console.log(chalk.cyan.bold(`  ${AI_PLATFORMS.cli.label}:`));
+  for (const platform of AI_PLATFORMS.cli.platforms) {
+    const wasPreviouslySelected = previouslySelected && previouslySelected.includes(platform.id);
+    const isPreselected = preselected.includes(platform.id);
+    const marker = wasPreviouslySelected ? chalk.green(' ✓ (previously selected)') : '';
+    console.log(chalk.white(`    ${index}. ${platform.name}`) + chalk.gray(` - ${platform.desc}`) + marker);
+    indexMap[index] = platform.id;
+    if (isPreselected) preSelectedIndices.push(index);
+    index++;
+  }
+
+  console.log('');
+
+  // Show default based on preselected (auto-detected + previously selected)
   const defaultHint = preSelectedIndices.length > 0
-    ? `Enter for previous: ${preSelectedIndices.join(',')}`
+    ? `Enter for selected: ${preSelectedIndices.join(',')}`
     : 'e.g., 1,2,3 or "all"';
 
   const answer = await question(chalk.yellow(`Your selection (${defaultHint}): `));
   rl.close();
 
-  // If user just pressed enter and we have previous selections, use them
+  // If user just pressed enter and we have preselected platforms, use them
   if (answer.trim() === '' && preSelectedIndices.length > 0) {
-    return previouslySelected;
+    return preselected;
   }
 
   if (answer.toLowerCase() === 'all') {
@@ -387,6 +464,21 @@ export function showAvailablePlatforms(currentIds) {
     index++;
   }
 
+  console.log('');
+
+  // CLI-based platforms
+  console.log(chalk.cyan.bold(`  ${AI_PLATFORMS.cli.label}:`));
+  for (const platform of AI_PLATFORMS.cli.platforms) {
+    const status = currentIds.includes(platform.id)
+      ? chalk.green(' ✓ (installed)')
+      : chalk.gray(' (not installed)');
+    console.log(chalk.white(`    ${index}. ${platform.name}`) + status);
+    if (!currentIds.includes(platform.id)) {
+      available.push({ index, platform });
+    }
+    index++;
+  }
+
   return available;
 }