Welcome to ProjXO CLI Tool Documentation

Complete guide to using and mastering ProjXO CLI Tool.

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 versionLicense: MIT

āœØ What is ProjXO?

Create projects. Track them. Never lose them.

ProjXO eliminates the repetitive setup process for new projects. Instead of:

npx create-vite my-app
cd my-app
npm install
code .
# Wait... where did I save that other project?

You get:

pxo              # Create & track new projects
pxo track        # Add any existing project to tracking
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.

šŸ“Š How It Works

Automatic Tracking

Every project you create with ProjXO is automatically tracked:

pxo
# Creates project...
āœ“ Project added to tracking

# Data stored in: ~/.projxo/projects.json

Track Existing Projects

Already have projects that weren't created through ProjXO? Use pxo track to add them:

pxo track                          # Track current directory
pxo track ~/projects/my-old-app   # Track a specific path

ProjXO auto-detects the framework, language, and package manager. Works with any project ā€” not just JavaScript.

What's Stored

  • 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

Command Not Found

# Reinstall globally
npm install -g projxo

# Or use with npx
npx projxo

Permission Errors (macOS/Linux)

sudo chown -R $(whoami) ~/.npm
sudo chown -R $(whoami) /usr/local/lib/node_modules
npm install -g projxo

IDE Doesn't Open

  1. Verify IDE is installed
  2. Setup command-line tools (see IDE Integration)
  3. Test manually: code . or cursor .

Projects Not Showing in List

Projects created before v1.1.0 aren't tracked.

Only projects created after installing v1.1.0+ are automatically tracked. For older projects, use pxo track to add them manually.

Project Not Found (Open Command)

If pxo open can't find your project:

# Use list to see exact names
pxo list

# Or 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:

git clone https://github.com/sasangachathumal/ProjXO.git
cd ProjXO
npm install
node index.js    # Test locally

Getting Help

If you need help, check out:

NextInstallation