projxo 1.1.0 → 1.2.0

package/Readme.md

@@ -21,6 +21,12 @@ pxo
 
 # List all your projects
 pxo list
+
+# Open a project quickly
+pxo open my-app
+
+# List all your recently accessed projects
+pxo recent
 ```
 
 **That's it!** Pick your framework, name your project, and start coding.
@@ -46,6 +52,8 @@ You get:
 ```bash
 pxo              # Create & track projects
 pxo list         # See all your projects
+pxo open my-app  # Open instantly
+pxo recent       # See all recent projects
 ```
 
 **One command. Zero hassle.**
@@ -71,6 +79,8 @@ npm install -g projxo
 |---------|-------|-------------|
 | `pxo` | - | Create a new project with interactive setup |
 | `pxo list` | `pxo ls` | Browse and manage all tracked projects |
+| `pxo recent [limit]` | - | Browse recently accessed projects |
+| `pxo open <project-name>` | - | Quick open project by name |
 | `pxo --version` | `pxo -V` | Show version number |
 | `pxo --help` | `pxo -h` | Display help information |
 
@@ -155,6 +165,75 @@ Select a project and perform actions
 Use ↑↓ to navigate • Enter to select
 ```
 
+### Recent Projects
+
+```bash
+pxo recent
+# or with custom limit
+pxo recent 5
+```
+
+***Shows your recently accessed projects (default: last 10)***
+
+**Features:**
+
+- Sorted by last accessed time (most recent first)
+- Quick selection with arrow keys
+- Select to open in your preferred IDE
+
+**Example output:**
+
+``` bash
+🕐 Recent Projects (5)
+
+Select a project to open:
+❯ 1.  my-awesome-app      React+Vite    2 hours ago
+  2.  client-dashboard    Next.js       1 day ago
+  3.  mobile-game         React Native  3 days ago
+  4.  api-server          Next.js       5 days ago
+  5.  test-project        React+Vite    1 week ago
+```
+
+**Use case:** Perfect for quickly switching between active projects without browsing the full list.
+
+### Quick Open Project
+
+```bash
+pxo open <project-name>
+```
+
+**Instantly open a project by name** - the fastest way to access your work.
+
+**Features:**
+
+- Direct project opening by name
+- Fuzzy search if exact match not found
+- Opens in your preferred IDE
+- Updates last accessed timestamp
+
+**Example output:**
+
+``` bash
+# Exact match
+pxo open my-awesome-app
+
+# Fuzzy match (finds "my-awesome-app")
+pxo open awesome
+
+# Multiple matches - shows selection menu
+pxo open app
+```
+
+```bash
+$ pxo open dashboard
+
+Found similar project: client-dashboard
+✓ Opening client-dashboard in VS Code...
+✓ Opened client-dashboard
+```
+
+**Use case:** When you know the project name, this is the fastest way to open it.
+
 ---
 
 ### Version & Help
@@ -209,10 +288,46 @@ $ pxo list
 # - View details
 ```
 
+### Example 3: Quick Access Workflow
+
+```bash
+# Morning: See what you worked on recently
+$ pxo recent
+# → Select and open your active project
+
+# Later: Quick open by name
+$ pxo open client-dashboard
+✓ Opened client-dashboard
+
+# End of day: Browse all projects
+$ pxo list
+# → Review and organize
+```
+
 ---
 
 ## 💡 Tips & Tricks
 
+### Use Recent for Active Work
+
+```bash
+# Working on multiple projects?
+pxo recent
+
+# Shows only what you've touched recently
+# Much faster than scrolling through all projects
+```
+
+### Quick Open for Speed
+
+```bash
+# If you remember the name, use open
+pxo open my-app
+
+# Fuzzy search helps with partial names
+pxo open dash  # finds "client-dashboard"
+```
+
 ### Organize Your Projects
 
 ```bash
@@ -298,6 +413,18 @@ npm install -g projxo
 
 Only projects created after installing v1.1.0+ are automatically tracked.
 
+### Project Not Found (Open Command)
+
+If `pxo open` can't find your project:
+
+```bash
+# Use list to see exact names
+pxo list
+
+# Or try partial name (fuzzy search)
+pxo open partial-name
+```
+
 ---
 
 ## 🤝 Contributing
@@ -365,6 +492,13 @@ pxo
 pxo list
 pxo ls
 
+# Recent projects
+pxo recent
+pxo recent 5
+
+# Quick open
+pxo open <project-name>
+
 # Version
 pxo --version
 pxo -V

package/index.js

@@ -6,12 +6,14 @@
  * Entry point for the CLI application
  * Handles command routing and argument parsing
  * 
- * @version 1.1.0
+ * @version 1.2.0
  */
 
 const { program } = require('commander');
 const { run: createProject } = require('./src/cli');
 const { listCommand } = require('./src/commands/list');
+const { recentCommand } = require('./src/commands/recent');
+const { openCommand } = require('./src/commands/open');
 const logger = require('./src/utils/logger');
 
 // Package info
@@ -38,6 +40,23 @@ program
     listCommand();
   });
 
+// Show recent projects
+program
+  .command('recent')
+  .description('Show recently accessed projects')
+  .argument('[limit]', 'number of projects to show', '10')
+  .action((limit) => {
+    recentCommand(parseInt(limit));
+  });
+
+// Open project
+program
+  .command('open [project-name]')
+  .description('Open a project in IDE')
+  .action((projectName) => {
+    openCommand(projectName);
+  });
+
 // Handle errors
 program.exitOverride();
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "projxo",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Cross-platform CLI tool to quickly create React, Next.js, Angular, and React Native projects with automatic IDE integration",
   "main": "index.js",
   "bin": {

package/src/commands/list.js

@@ -67,11 +67,12 @@ async function listCommand() {
     
     // Create choices for inquirer
     const choices = projects.map(project => {
-      const typeDisplay = getTypeDisplay(project.type);
-      const timeAgo = formatRelativeTime(project.lastAccessed);
+      const typeDisplay = getTypeDisplay(project.type).padEnd(16);
+      const timeAgo = formatRelativeTime(project.lastAccessed).padEnd(15);
+      const nameDisplay = project.name.padEnd(30);
       
       return {
-        name: `${project.name}  │  ${typeDisplay}  │  ${timeAgo}`,
+        name: `${nameDisplay} ${typeDisplay} ${timeAgo}`,
         value: project.id,
         short: project.name
       };

package/src/commands/open.js

@@ -0,0 +1,119 @@
+/**
+ * Open command - Quick open project by name
+ * Usage: pxo open <project-name>
+ */
+
+const inquirer = require('inquirer');
+const { getProjectByName, touchProject, searchProjects } = require('../storage/projects');
+const { openInIDE } = require('../handlers/ideOpener');
+const { getIDEChoices } = require('../config/ides');
+const logger = require('../utils/logger');
+
+/**
+ * Execute open command
+ * @param {string} projectName - Project name to open
+ */
+async function openCommand(projectName) {
+  try {
+    if (!projectName) {
+      logger.error('Please provide a project name');
+      logger.log('\nUsage:', 'dim');
+      logger.log('  pxo open <project-name>', 'cyan');
+      return;
+    }
+    
+    // Try to find project
+    let project = getProjectByName(projectName);
+    
+    // If not found, try fuzzy search
+    if (!project) {
+      const matches = searchProjects(projectName);
+      
+      if (matches.length === 0) {
+        logger.error(`Project "${projectName}" not found`);
+        logger.log('\nList all projects with:', 'dim');
+        logger.log('  pxo list', 'cyan');
+        return;
+      }
+      
+      if (matches.length === 1) {
+        project = matches[0];
+        logger.info(`Found similar project: ${project.name}`);
+      } else {
+        // Multiple matches, let user choose
+        project = await selectFromMatches(matches);
+        if (!project) return;
+      }
+    }
+    
+    // Update last accessed time
+    touchProject(project.id);
+    
+    // Determine which IDE to use
+    let ideKey = project.ide;
+    
+    if (!ideKey || ideKey === 'skip') {
+      const { selectedIDE } = await inquirer.prompt([
+        {
+          type: 'list',
+          name: 'selectedIDE',
+          message: `Open "${project.name}" in:`,
+          choices: getIDEChoices()
+        }
+      ]);
+      ideKey = selectedIDE;
+    }
+    
+    // Open in IDE
+    if (ideKey !== 'skip') {
+      const success = await openInIDE(project.path, ideKey);
+      if (success) {
+        logger.success(`Opened ${project.name}`);
+      }
+    } else {
+      logger.info(`Project path: ${project.path}`);
+    }
+    
+  } catch (error) {
+    logger.error(`Failed to open project: ${error.message}`);
+  }
+}
+
+/**
+ * Let user select from multiple matches
+ * @param {Array} matches - Array of matching projects
+ * @returns {Promise<Object|null>} Selected project or null
+ */
+async function selectFromMatches(matches) {
+  logger.info(`Found ${matches.length} matching projects:`);
+  logger.newLine();
+  
+  const choices = matches.map(p => ({
+    name: `${p.name} (${p.type})`,
+    value: p.id,
+    short: p.name
+  }));
+  
+  choices.push(
+    new inquirer.Separator(),
+    { name: '← Cancel', value: 'cancel' }
+  );
+  
+  const { selectedId } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'selectedId',
+      message: 'Which project did you mean?',
+      choices
+    }
+  ]);
+  
+  if (selectedId === 'cancel') {
+    return null;
+  }
+  
+  const { getProjectById } = require('../storage/projects');
+  return getProjectById(selectedId);
+}
+
+module.exports = { openCommand };

package/src/commands/recent.js

@@ -0,0 +1,156 @@
+/**
+ * Recent command - Show recently accessed projects
+ * Usage: pxo recent [limit]
+ */
+
+const inquirer = require('inquirer');
+const { getRecentProjects, touchProject } = require('../storage/projects');
+const { openInIDE } = require('../handlers/ideOpener');
+const logger = require('../utils/logger');
+
+/**
+ * Format relative time (same as list.js)
+ * @param {string} isoDate - ISO date string
+ * @returns {string} Human-readable relative time
+ */
+function formatRelativeTime(isoDate) {
+  const date = new Date(isoDate);
+  const now = new Date();
+  const diffMs = now - date;
+  const diffMins = Math.floor(diffMs / 60000);
+  const diffHours = Math.floor(diffMs / 3600000);
+  const diffDays = Math.floor(diffMs / 86400000);
+  
+  if (diffMins < 1) return 'just now';
+  if (diffMins < 60) return `${diffMins} min${diffMins > 1 ? 's' : ''} ago`;
+  if (diffHours < 24) return `${diffHours} hour${diffHours > 1 ? 's' : ''} ago`;
+  if (diffDays < 7) return `${diffDays} day${diffDays > 1 ? 's' : ''} ago`;
+  if (diffDays < 30) return `${Math.floor(diffDays / 7)} week${Math.floor(diffDays / 7) > 1 ? 's' : ''} ago`;
+  return `${Math.floor(diffDays / 30)} month${Math.floor(diffDays / 30) > 1 ? 's' : ''} ago`;
+}
+
+/**
+ * Get project type display name
+ * @param {string} type - Project type key
+ * @returns {string} Formatted display name
+ */
+function getTypeDisplay(type) {
+  const typeMap = {
+    'react-vite': 'React+Vite',
+    'react-vite-ts': 'React+Vite(TS)',
+    'nextjs': 'Next.js',
+    'angular': 'Angular',
+    'react-native': 'React Native'
+  };
+  return typeMap[type] || type;
+}
+
+/**
+ * Execute recent command
+ * @param {number} limit - Number of recent projects to show
+ */
+async function recentCommand(limit = 10) {
+  try {
+    const projects = getRecentProjects(limit);
+    
+    if (projects.length === 0) {
+      logger.info('No recent projects found');
+      logger.log('\nCreate your first project with:', 'dim');
+      logger.log('  pxo', 'cyan');
+      return;
+    }
+    
+    logger.newLine();
+    logger.log(`🕐 Recent Projects (${projects.length})`, 'bright');
+    logger.newLine();
+    
+    // Create choices for inquirer
+    const choices = projects.map((project, index) => {
+      const typeDisplay = getTypeDisplay(project.type).padEnd(16);
+      const timeAgo = formatRelativeTime(project.lastAccessed).padEnd(15);
+      const indexDisplay = `${index + 1}.`.padEnd(4);
+      const nameDisplay = project.name.padEnd(30);
+      
+      return {
+        name: `${indexDisplay}${nameDisplay} ${typeDisplay} ${timeAgo}`,
+        value: project.id,
+        short: project.name
+      };
+    });
+    
+    // Add separator and back option
+    choices.push(
+      new inquirer.Separator(),
+      { name: '← Cancel', value: 'cancel' }
+    );
+    
+    const { selectedId } = await inquirer.prompt([
+      {
+        type: 'list',
+        name: 'selectedId',
+        message: 'Select a project to open:',
+        choices,
+        pageSize: 15
+      }
+    ]);
+    
+    if (selectedId === 'cancel') {
+      return;
+    }
+    
+    // Open selected project
+    await openSelectedProject(selectedId);
+    
+  } catch (error) {
+    if (error.isTtyError) {
+      logger.error('This command requires an interactive terminal');
+    } else {
+      logger.error(`Failed to show recent projects: ${error.message}`);
+    }
+  }
+}
+
+/**
+ * Open selected project in IDE
+ * @param {string} projectId - Project ID
+ */
+async function openSelectedProject(projectId) {
+  const { getProjectById } = require('../storage/projects');
+  const { getIDEChoices } = require('../config/ides');
+  
+  const project = getProjectById(projectId);
+  
+  if (!project) {
+    logger.error('Project not found');
+    return;
+  }
+  
+  // Update last accessed time
+  touchProject(project.id);
+  
+  // Use project's preferred IDE or prompt
+  let ideKey = project.ide;
+  
+  if (!ideKey || ideKey === 'skip') {
+    const { selectedIDE } = await inquirer.prompt([
+      {
+        type: 'list',
+        name: 'selectedIDE',
+        message: 'Select IDE:',
+        choices: getIDEChoices()
+      }
+    ]);
+    ideKey = selectedIDE;
+  }
+  
+  if (ideKey !== 'skip') {
+    const success = await openInIDE(project.path, ideKey);
+    if (success) {
+      logger.success(`Opened ${project.name}`);
+    }
+  } else {
+    logger.info(`Project path: ${project.path}`);
+  }
+}
+
+module.exports = { recentCommand };