Cross-platform CLI tool to quickly create React, Next.js, Angular, and React Native projects with automatic IDE integration
npm install projxoOne command, Any framework
> Quick project setup and management CLI for modern web frameworks
> Create projects in seconds. Never lose track of them again.


---
``bashInstall globally
npm install -g projxo
That's it! Pick your framework, name your project, and start coding.
---
⨠What is ProjXO?
Create projects. Track them. Never lose them.
ProjXO eliminates the repetitive setup process for new projects. Instead of:
`bash
npx create-vite my-app
cd my-app
npm install
code .
Wait... where did I save that other project?
`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
pxo stats # See stats of all projects
`One command. Zero hassle.
---
š¦ Installation
`bash
npm install -g projxo
`Requirements:
- Node.js >= 14.0.0
- npm >= 6.0.0
---
š ļø 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 | - | Quick open project by name |
| pxo stats | - | View statistics of the projects created |
| pxo --version | pxo -V | Show version number |
| pxo --help | pxo -h | Display help information |---
$3
`bash
pxo
`Interactive prompts guide you through:
1. Framework selection (React, Next.js, Angular, React Native)
2. Project name
3. Location
4. IDE preference
#### Supported frameworks:
- Angular (Latest version)
- Ionic + React (Mobile apps)
- Ionic + Angular (Mobile apps)
- Ionic + Vue (Mobile apps)
- Next.js (App Router, TypeScript)
- Next.js + shadcn/ui (Pre-configured with shadcn components)
- Nuxt.js (Vue.js framework)
- React + Vite (JavaScript or TypeScript)
- React Native (Expo)
#### Supported IDEs:
ProjXO auto-opens projects in your preferred IDE:
- VS Code (
code)
- Cursor (cursor)
- WebStorm (webstorm)
- IntelliJ IDEA (idea)
- Sublime Text (subl)
- Atom (atom)Setup command-line tools:
VS Code:
1. Open Command Palette (
Cmd/Ctrl+Shift+P)
2. Type: "Shell Command: Install 'code' command in PATH"Other IDEs: Check your IDE's documentation for CLI setup.
---
$3
`bash
pxo list
or
pxo ls
`Shows all your tracked projects with:
- Project name
- Framework type
- Last accessed time
Interactive actions:
Select a project and perform actions
- š Open in IDE
- š Copy project path
- šļø Remove from tracking
- ā¹ļø Show detailed info
Example output:
` bash
š¦ Your Projects (5)⯠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
Use āā to navigate ⢠Enter to select
`$3
`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.
$3
`bash
pxo open
`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-appFuzzy match (finds "my-awesome-app")
pxo open awesomeMultiple matches - shows selection menu
pxo open app
``bash
$ pxo open dashboardFound 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.
---
$3
`bash
pxo stats
`View status of projects created through projxo.
Features:
- View projects count
- View projects count and presentage by framework type
- View most used IDE
- View newest and oldest projects
Example output:
`bash
$ pxo statsš Project Statistics
===========================
Total Projects: 12
Projects by Type:
react-vite 2 (17%) āāā
react-vite-ts 1 (8%) ā
nextjs 2 (17%) āāā
Most Used IDE: vscode
Recent Activity:
Newest: next-cn2-test (Jan 8, 2026)
Oldest: test-project-1765197012999 (Dec 8, 2025)
`---
$3
`bash
Check version
pxo --versionShow help
pxo --help
`---
š Usage Examples
$3
`bash
$ pxo? Select project type: React + Vite
? Enter project name: my-landing-page
? Enter directory: ~/projects
? Select IDE: VS Code
ā Project created successfully!
ā Project added to tracking
Start developing:
cd ~/projects/my-landing-page
npm run dev
`---
$3
`bash
$ pxo listš¦ Your Projects (3)
⯠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
`$3
`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-dashboardEnd of day: Browse all projects
$ pxo list
ā Review and organize
`---
š” Tips & Tricks
$3
`bash
Working on multiple projects?
pxo recentShows only what you've touched recently
Much faster than scrolling through all projects
`$3
`bash
If you remember the name, use open
pxo open my-appFuzzy search helps with partial names
pxo open dash # finds "client-dashboard"
`$3
`bash
Keep projects organized
~/projects/clients/
~/projects/personal/
~/projects/learning/Create projects in the right place
cd ~/projects/clients
pxo
`$3
`bash
pxo list
ā Select project ā Show details
See full information:
- Complete path
- Creation date
- Framework type
- Default IDE
`---
š How It Works
$3
Every project you create with ProjXO is automatically tracked:
`bash
pxo
Creates project...
ā Project added to trackingData stored in: ~/.projxo/projects.json
`$3
- Project name and path
- Framework type
- Creation and last accessed timestamps
- IDE preference
Privacy: All data stays local on your machine. No cloud sync, no tracking.
---
šØ Troubleshooting
$3
`bash
Reinstall globally
npm install -g projxoOr use with npx
npx projxo
`$3
`bash
sudo chown -R $(whoami) ~/.npm
sudo chown -R $(whoami) /usr/local/lib/node_modules
npm install -g projxo
`$3
1. Verify IDE is installed
2. Setup command-line tools (see IDE Integration)
3. Test manually:
code . or cursor .$3
Projects created before v1.1.0 aren't tracked.
Only projects created after installing v1.1.0+ are automatically tracked.
$3
If
pxo open can't find your project:`bash
Use list to see exact names
pxo listOr try partial name (fuzzy search)
pxo open partial-name
`---
š¤ Contributing
Contributions are welcome! Please use pull requests.
Ways to contribute:
- š Report bugs
- š” Suggest features
- š Improve docs
- š§ Submit PRs
Development setup:
`bash
git clone https://github.com/sasangachathumal/ProjXO.git
cd ProjXO
npm install
node index.js # Test locally
`---
š License
MIT Ā© Sasanga Chathumal
---
š Credits
Built with:
- Vite
- Next.js
- Angular CLI
- Expo
- Inquirer.js
- Commander.js
---
š¬ Support & Links
- š Documentation
- š Issues
- š¬ Discussions
- š¦ npm Package
Connect:
- š¦ X/Twitter
- š¼ LinkedIn
- š§ Email
---
ā” Quick Reference
`bash
Create project
pxoList projects
pxo list
pxo lsRecent projects
pxo recent
pxo recent 5Quick open
pxo open Version
pxo --version
pxo -VHelp
pxo --help
pxo -h
``---
Stop wasting time on setup. Start building.
ā Star on GitHub ⢠š¦ Install Now ⢠š Report Issue