projxo 1.0.2 → 1.2.0

package/Readme.md

@@ -1,483 +1,450 @@
 # ProjXO
 
-> **Quick project setup CLI for modern web frameworks**  
-> Stop wasting time with repetitive project scaffolding. Create production-ready projects in seconds.
+**One command, Any framework**
+
+> **Quick project setup and management CLI for modern web frameworks**  
+> Create projects in seconds. Never lose track of them again.
 
 [![npm version](https://img.shields.io/npm/v/projxo.svg)](https://www.npmjs.com/package/projxo)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 ---
 
-## 🚀 Why ProjXO?
+## 🚀 Quick Start
+
+```bash
+# Install globally
+npm install -g projxo
+
+# Create a new project
+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.
+
+---
+
+## ✨ What is ProjXO?
 
-As developers, we create new projects constantly—prototypes, client work, side projects, experiments. But every time, we go through the same tedious process:
+**Create projects. Track them. Never lose them.**
+
+ProjXO eliminates the repetitive setup process for new projects. Instead of:
 
 ```bash
-# The old way (too many steps!)
 npx create-vite my-app
 cd my-app
 npm install
 code .
+# Wait... where did I save that other project?
 ```
 
-**ProjXO does it all in one interactive command:**
+You get:
 
 ```bash
-pxo
+pxo              # Create & track projects
+pxo list         # See all your projects
+pxo open my-app  # Open instantly
+pxo recent       # See all recent projects
 ```
 
-That's it. Pick your framework, name your project, choose where it goes, and you're coding in seconds.
-
----
-
-## ✨ Features
-
-- **🎯 One Command Setup** - Interactive CLI guides you through everything
-- **⚡ Latest Tools** - Uses current best practices (Vite, not deprecated CRA)
-- **🎨 Multiple Frameworks** - React, Next.js, Angular, React Native
-- **🔧 IDE Integration** - Auto-opens in VS Code, Cursor, WebStorm, etc.
-- **🌍 Cross-Platform** - Works on macOS, Windows, and Linux
-- **💨 Zero Config** - No setup files, no configuration needed
+**One command. Zero hassle.**
 
 ---
 
 ## 📦 Installation
 
-### Global Installation (Recommended)
-
 ```bash
 npm install -g projxo
 ```
 
-Now use from anywhere:
+**Requirements:**
 
-```bash
-pxo
-```
+- Node.js >= 14.0.0
+- npm >= 6.0.0
 
-### npx (No Install)
+---
 
-```bash
-npx projxo
-```
+## 🛠️ Available Commands
 
----
+| Command | Alias | Description |
+|---------|-------|-------------|
+| `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 |
 
-## 🎯 Quick Start
+---
 
-### Create Your First Project
+### Create New Project
 
 ```bash
 pxo
 ```
 
-That's it! The CLI will:
+**Interactive prompts guide you through:**
 
-1. Ask what framework you want (React, Next.js, Angular, or React Native)
-2. Ask for your project name
-3. Ask where to create it
-4. Ask which IDE to open it in
-5. Create the project and open it
+1. Framework selection (React, Next.js, Angular, React Native)
+2. Project name
+3. Location
+4. IDE preference
 
-**Total time: ~30 seconds** ⚡
+#### **Supported frameworks:**
 
----
+- **React + Vite** (JavaScript or TypeScript)
+- **Next.js** (App Router, TypeScript)
+- **Angular** (Latest version)
+- **React Native** (Expo)
 
-## 🛠️ Supported Project Types
+#### **Supported IDEs:**
 
-### React + Vite (JavaScript)
+ProjXO auto-opens projects in your preferred IDE:
 
-Modern React development with Vite's lightning-fast HMR
+- **VS Code** (`code`)
+- **Cursor** (`cursor`)
+- **WebStorm** (`webstorm`)
+- **IntelliJ IDEA** (`idea`)
+- **Sublime Text** (`subl`)
+- **Atom** (`atom`)
 
-```bash
-pxo
-# Select: React + Vite
-```
+**Setup command-line tools:**
+
+**VS Code:**
 
-**Includes:**
+1. Open Command Palette (`Cmd/Ctrl+Shift+P`)
+2. Type: "Shell Command: Install 'code' command in PATH"
 
-- React 18+
-- Vite 5+
-- ESLint configuration
-- Fast Refresh
+**Other IDEs:** Check your IDE's documentation for CLI setup.
 
-### React + Vite (TypeScript)
+---
 
-Type-safe React with Vite
+### List All Projects
 
 ```bash
-pxo
-# Select: React + Vite (TypeScript)
+pxo list
+# or
+pxo ls
 ```
 
-**Includes:**
+**Shows all your tracked projects with:**
 
-- Everything from React + Vite
-- TypeScript 5+
-- Type definitions
+- Project name
+- Framework type
+- Last accessed time
 
-### Next.js
+**Interactive actions:**
 
-Production-ready React framework
+Select a project and perform actions
 
-```bash
-pxo
-# Select: Next.js
-```
+- 📂 Open in IDE
+- 📋 Copy project path
+- 🗑️ Remove from tracking
+- ℹ️ Show detailed info
 
-**Includes:**
+**Example output:**
 
-- Next.js 14+ (App Router)
-- TypeScript support
-- ESLint + Prettier
-- Optimized build setup
+``` bash
+📦 Your Projects (5)
 
-### Angular
+❯ my-awesome-app     React+Vite    2 hours ago
+  client-dashboard   Next.js       1 day ago
+  mobile-game        React Native  3 days ago
+  legacy-project     Angular       1 week ago
+  test-app           React+Vite    2 weeks ago
 
-Enterprise-grade framework
+Use ↑↓ to navigate • Enter to select
+```
+
+### Recent Projects
 
 ```bash
-pxo
-# Select: Angular
+pxo recent
+# or with custom limit
+pxo recent 5
 ```
 
-**Includes:**
+***Shows your recently accessed projects (default: last 10)***
 
-- Angular 17+
-- TypeScript
-- Angular CLI tools
-- Testing setup
+**Features:**
 
-### React Native (Expo)
+- Sorted by last accessed time (most recent first)
+- Quick selection with arrow keys
+- Select to open in your preferred IDE
 
-Mobile apps with React
+**Example output:**
 
-```bash
-pxo
-# Select: React Native (Expo)
+``` 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
 ```
 
-**Includes:**
+**Use case:** Perfect for quickly switching between active projects without browsing the full list.
 
-- Expo SDK
-- TypeScript support
-- Development tools
-- Platform-specific configurations
+### Quick Open Project
 
----
+```bash
+pxo open <project-name>
+```
 
-## 🎨 IDE Integration
+**Instantly open a project by name** - the fastest way to access your work.
 
-ProjXO can automatically open your project in your preferred IDE:
+**Features:**
 
-### Supported IDEs
+- Direct project opening by name
+- Fuzzy search if exact match not found
+- Opens in your preferred IDE
+- Updates last accessed timestamp
 
-- **VS Code** - `code` command
-- **Cursor** - `cursor` command
-- **WebStorm** - `webstorm` command
-- **IntelliJ IDEA** - `idea` command
-- **Sublime Text** - `subl` command
-- **Atom** - `atom` command
+**Example output:**
 
-### Setup IDE Command-Line Tools
+``` bash
+# Exact match
+pxo open my-awesome-app
 
-**VS Code:**
+# Fuzzy match (finds "my-awesome-app")
+pxo open awesome
 
-1. Open VS Code
-2. Press `Cmd/Ctrl + Shift + P`
-3. Type "Shell Command: Install 'code' command in PATH"
-4. Done!
+# Multiple matches - shows selection menu
+pxo open app
+```
 
-**Cursor:**
-Usually available after installation
+```bash
+$ pxo open dashboard
 
-**WebStorm/IntelliJ:**
-Tools → Create Command-line Launcher
+Found similar project: client-dashboard
+✓ Opening client-dashboard in VS Code...
+✓ Opened client-dashboard
+```
 
-**Others:**
-Refer to your IDE's documentation
+**Use case:** When you know the project name, this is the fastest way to open it.
 
 ---
 
-## 📖 Usage Examples
-
-### Example 1: Enterprise Web App
+### Version & Help
 
 ```bash
-pxo
-
-# Select: Angular
-# Name: my-ent-app
-# Directory: ~/projects
-# IDE: VS Code
+# Check version
+pxo --version
 
-# Project created and opened in VS Code!
-# Start: npm run dev
+# Show help
+pxo --help
 ```
 
-### Example 2: Landing Page
+---
+
+## 📖 Usage Examples
+
+### Example 1: Create React App
 
 ```bash
-pxo
+$ pxo
 
-# Select: React + Vite
-# Name: my-landing-page
-# Directory: ~/projects
-# IDE: VS Code
+? Select project type: React + Vite
+? Enter project name: my-landing-page
+? Enter directory: ~/projects
+? Select IDE: VS Code
 
-# Project created and opened in VS Code!
-# Start: npm run dev
+✓ Project created successfully!
+✓ Project added to tracking
+
+# Start developing:
+cd ~/projects/my-landing-page
+npm run dev
 ```
 
-### Example 3: Full-Stack App
+---
+
+### Example 2: Browse Your Projects
 
 ```bash
-pxo
+$ pxo list
 
-# Select: Next.js
-# Name: my-saas-app
-# Directory: ~/work
-# IDE: Cursor
+📦 Your Projects (3)
 
-# Next.js project with TypeScript ready!
-# Start: npm run dev
+❯ my-landing-page    React+Vite    just now
+  my-nextjs-app      Next.js       2 days ago
+  old-angular-app    Angular       2 weeks ago
+
+# Select a project to:
+# - Open in your IDE
+# - Copy the path
+# - Remove from tracking
+# - View details
 ```
 
-### Example 4: Mobile App
+### Example 3: Quick Access Workflow
 
 ```bash
-pxo
+# Morning: See what you worked on recently
+$ pxo recent
+# → Select and open your active project
 
-# Select: React Native (Expo)
-# Name: my-mobile-app
-# Directory: ~/apps
-# IDE: VS Code
+# Later: Quick open by name
+$ pxo open client-dashboard
+✓ Opened client-dashboard
 
-# Expo project ready!
-# Start: npx expo start
+# End of day: Browse all projects
+$ pxo list
+# → Review and organize
 ```
 
 ---
 
-## ⚙️ Configuration
+## 💡 Tips & Tricks
 
-ProjXO works out of the box with zero configuration. However, you can customize some behaviors:
-
-### Default Directory
-
-ProjXO uses your current directory by default. Change it during the prompt or `cd` to your preferred location first:
+### Use Recent for Active Work
 
 ```bash
-cd ~/projects
-pxo
-```
-
-### Skip IDE Opening
+# Working on multiple projects?
+pxo recent
 
-If you prefer to open projects manually:
-
-```bash
-pxo
-# Select: Skip (open manually)
+# Shows only what you've touched recently
+# Much faster than scrolling through all projects
 ```
 
----
-
-## 🎓 Tips & Best Practices
-
-### Tip 1: Use Consistent Naming
+### Quick Open for Speed
 
 ```bash
-# Good naming conventions
-my-project-name    ✓
-my_project_name    ✓
-MyProjectName      ✓
-
-# Avoid
-my project name    ✗ (spaces)
-my-project-name!   ✗ (special chars)
+# If you remember the name, use open
+pxo open my-app
+
+# Fuzzy search helps with partial names
+pxo open dash  # finds "client-dashboard"
 ```
 
-### Tip 2: Organize Projects
+### Organize Your Projects
 
 ```bash
-# Keep projects organized by type
+# Keep projects organized
 ~/projects/clients/
 ~/projects/personal/
-~/projects/experiments/
+~/projects/learning/
 
-# Use ProjXO in each folder
+# Create projects in the right place
 cd ~/projects/clients
 pxo
 ```
 
-### Tip 3: Learn the Frameworks
+### Review Project Details
 
-ProjXO uses official tools:
+```bash
+pxo list
+# → Select project → Show details
+
+# See full information:
+# - Complete path
+# - Creation date
+# - Framework type
+# - Default IDE
+```
 
-- **React + Vite**: [vitejs.dev/guide](https://vitejs.dev/guide/)
-- **Next.js**: [nextjs.org/docs](https://nextjs.org/docs)
-- **Angular**: [angular.io/docs](https://angular.io/docs)
-- **Expo**: [docs.expo.dev](https://docs.expo.dev)
+---
 
-### Tip 4: Post-Setup Tasks
+## 📊 How It Works
 
-After project creation:
+### Automatic Tracking
 
-**For all projects:**
+Every project you create with ProjXO is automatically tracked:
 
 ```bash
-cd your-project
-git init
-git add .
-git commit -m "Initial commit"
-```
+pxo
+# Creates project...
+✓ Project added to tracking
 
-**Add common packages:**
+# Data stored in: ~/.projxo/projects.json
+```
 
-```bash
-# For React projects
-npm install axios react-query zustand
+### What's Stored
 
-# For styling
-npm install tailwindcss @shadcn/ui
+- Project name and path
+- Framework type
+- Creation and last accessed timestamps
+- IDE preference
 
-# For forms
-npm install react-hook-form zod
-```
+**Privacy:** All data stays local on your machine. No cloud sync, no tracking.
 
 ---
 
 ## 🚨 Troubleshooting
 
-### Issue: Command not found
-
-**Problem:** `pxo: command not found`
-
-**Solution:**
+### Command Not Found
 
 ```bash
 # Reinstall globally
 npm install -g projxo
 
-# Or use full path
+# Or use with npx
 npx projxo
 ```
 
-### Issue: Permission denied
-
-**Problem:** `EACCES: permission denied`
-
-**Solution (macOS/Linux):**
+### Permission Errors (macOS/Linux)
 
 ```bash
-# Fix npm permissions
 sudo chown -R $(whoami) ~/.npm
 sudo chown -R $(whoami) /usr/local/lib/node_modules
-
-# Then reinstall
 npm install -g projxo
 ```
 
-**Solution (Windows):**
-Run terminal as Administrator
-
-### Issue: IDE doesn't open
-
-**Problem:** IDE selected but doesn't open
+### IDE Doesn't Open
 
-**Solution:**
+1. Verify IDE is installed
+2. Setup command-line tools (see IDE Integration)
+3. Test manually: `code .` or `cursor .`
 
-1. Ensure IDE is installed
-2. Set up command-line tools (see IDE Integration section)
-3. Test command manually:
+### Projects Not Showing in List
 
-   ```bash
-   code .  # for VS Code
-   cursor . # for Cursor
-   ```
+**Projects created before v1.1.0 aren't tracked.**
 
-### Issue: Project creation fails
+Only projects created after installing v1.1.0+ are automatically tracked.
 
-**Problem:** Error during project creation
+### Project Not Found (Open Command)
 
-**Solutions:**
-
-- **Check internet connection** - npm needs to download packages
-- **Clear npm cache** - `npm cache clean --force`
-- **Update Node.js** - Ensure Node.js >= 14.0.0
-- **Check disk space** - Ensure enough space for node_modules
-
----
-
-## 🔧 Requirements
-
-- **Node.js** >= 14.0.0
-- **npm** >= 6.0.0 (comes with Node.js)
-- **Internet connection** (for downloading packages)
-
-### Check Your Versions
+If `pxo open` can't find your project:
 
 ```bash
-node --version   # Should be >= 14.0.0
-npm --version    # Should be >= 6.0.0
-```
+# Use list to see exact names
+pxo list
 
-### Update Node.js
-
-**Using nvm (recommended):**
-```bash
-nvm install 20
-nvm use 20
+# Or try partial name (fuzzy search)
+pxo open partial-name
 ```
 
-**Direct download:**
-[nodejs.org/download](https://nodejs.org/download)
-
 ---
 
 ## 🤝 Contributing
 
-ProjXO is open source and contributions are welcome!
-To make thing easy and manageable use PR (pull requests) as much as possible.
+Contributions are welcome! Please use pull requests.
 
-### Ways to Contribute
+**Ways to contribute:**
 
 - 🐛 Report bugs
-- 💡 Suggest features
-- 📖 Improve documentation
-- 🔧 Submit pull requests
+- 💡 Suggest features  
+- 📖 Improve docs
+- 🔧 Submit PRs
 
-### Development Setup
+**Development setup:**
 
 ```bash
-# Clone the repository
 git clone https://github.com/sasangachathumal/ProjXO.git
 cd ProjXO
-
-# Install dependencies
 npm install
-
-# Test locally
-node index.js
-
-# Test globally
-npm link
-pxo
-```
-
-### Project Structure
-
-```
-ProjXO/
-├── index.js                 # Entry point
-├── package.json
-└── src/
-    ├── cli.js              # Main CLI logic
-    ├── config/             # Framework & IDE configs
-    ├── utils/              # Helper functions
-    ├── prompts/            # User prompts
-    └── handlers/           # Business logic
+node index.js    # Test locally
 ```
 
 ---
@@ -486,56 +453,31 @@ ProjXO/
 
 MIT © Sasanga Chathumal
 
-See [LICENSE](LICENSE) file for details.
-
 ---
 
 ## 🙏 Credits
 
-ProjXO uses these amazing tools:
-
-- [Vite](https://vitejs.dev/) - Next generation frontend tooling
-- [Next.js](https://nextjs.org/) - React framework
-- [Angular CLI](https://angular.io/cli) - Angular development tools
-- [Expo](https://expo.dev/) - React Native framework
-- [Inquirer.js](https://github.com/SBoudrias/Inquirer.js) - Interactive CLI prompts
-
----
-
-## 🗺️ Roadmap
-
-### Current Version (v1.0.0)
-
-- ✅ Interactive project creation
-- ✅ 5 framework templates
-- ✅ IDE integration
-- ✅ Cross-platform support
-
-### Planned Features
-
-- 🔄 Project tracking and quick access
-- 🔄 Bookmarking favorite projects
-- 🔄 Custom project templates
-- 🔄 Post-setup automation (install common packages)
-- 🔄 Git options
-- 🔄 Team templates sharing
+Built with:
+- [Vite](https://vitejs.dev/)
+- [Next.js](https://nextjs.org/)
+- [Angular CLI](https://angular.io/cli)
+- [Expo](https://expo.dev/)
+- [Inquirer.js](https://github.com/SBoudrias/Inquirer.js)
+- [Commander.js](https://github.com/tj/commander.js)
 
 ---
 
-## 💬 Support
-
-### Get Help
+## 💬 Support & Links
 
 - 📖 [Documentation](https://github.com/sasangachathumal/ProjXO#readme)
-- 🐛 [Issue Tracker](https://github.com/sasangachathumal/ProjXO/issues)
+- 🐛 [Issues](https://github.com/sasangachathumal/ProjXO/issues)
 - 💬 [Discussions](https://github.com/sasangachathumal/ProjXO/discussions)
+- 📦 [npm Package](https://www.npmjs.com/package/projxo)
 
-### Stay Updated
+**Connect:**
 
-- ⭐ [Star on GitHub](https://github.com/sasangachathumal/ProjXO)
-- 🐦 [Follow on X](https://x.com/SasangaChathum1)
-- 💼 [Follow on linkedIn](https://www.linkedin.com/in/sasanga-chathumal/)
-- 📋 [Follow on facebook](https://www.facebook.com/profile.php?id=61582131982373)
+- 🐦 [X/Twitter](https://x.com/SasangaChathum1)
+- 💼 [LinkedIn](https://www.linkedin.com/in/sasanga-chathumal/)
 - 📧 [Email](mailto:devbysasanga@gmail.com)
 
 ---
@@ -543,58 +485,35 @@ ProjXO uses these amazing tools:
 ## ⚡ Quick Reference
 
 ```bash
-# Create new project
+# Create project
 pxo
 
-# Check version
-pxo --version
-
-# Get help
-pxo --help
-
-# Use without installing
-npx projxo
-```
-
----
-
-## 📊 Comparison
-
-### ProjXO vs Manual Setup
+# List projects
+pxo list
+pxo ls
 
-| Task | Manual | ProjXO |
-|------|--------|--------|
-| Choose framework | Research docs | Interactive selection |
-| Run create command | Remember exact command | Handled automatically |
-| Navigate to project | `cd` manually | Automatic |
-| Open in IDE | `code .` manually | Automatic |
-| **Total time** | **3-5 minutes** | **30 seconds** |
+# Recent projects
+pxo recent
+pxo recent 5
 
-### ProjXO vs Other Tools
+# Quick open
+pxo open <project-name>
 
-| Feature | ProjXO | create-* tools | Yeoman |
-|---------|--------|----------------|---------|
-| Interactive | ✅ | ⚠️ Varies | ✅ |
-| Multi-framework | ✅ | ❌ Single | ⚠️ Depends |
-| IDE Integration | ✅ | ❌ | ❌ |
-| Zero config | ✅ | ✅ | ❌ |
-| Modern tools | ✅ | ⚠️ Some outdated | ⚠️ Many outdated |
-
----
-
-## 🔗 Links
+# Version
+pxo --version
+pxo -V
 
-- **npm**: [npmjs.com/package/ProjXO](https://www.npmjs.com/package/ProjXO)
-- **GitHub**: [github.com/sasangachathumal/ProjXO](https://github.com/sasangachathumal/ProjXO)
-- **Issues**: [github.com/sasangachathumal/ProjXO/issues](https://github.com/sasangachathumal/ProjXO/issues)
-- **Changelog**: [CHANGELOG.md](CHANGELOG.md)
+# Help
+pxo --help
+pxo -h
+```
 
 ---
 
 <div align="center">
 
-**Made with ❤️ by developers, for developers**
+**Stop wasting time on setup. Start building.**
 
-[⭐ Star on GitHub](https://github.com/sasangachathumal/ProjXO) • [📦 npm Package](https://www.npmjs.com/package/ProjXO) • [🐛 Report Bug](https://github.com/sasangachathumal/ProjXO/issues)
+[⭐ Star on GitHub](https://github.com/sasangachathumal/ProjXO) • [📦 Install Now](https://www.npmjs.com/package/projxo) • [🐛 Report Issue](https://github.com/sasangachathumal/ProjXO/issues)
 
 </div>