Skip to main content

Multi-Project Management

Managing multiple projects efficiently with projax.

Adding Multiple Projects​

Add all your projects at once:

prx add ~/projects/project1 --name "Project 1"
prx add ~/projects/project2 --name "Project 2"
prx add ~/projects/project3 --name "Project 3"
prx add ~/projects/project4 --name "Project 4"

Scanning All Projects​

Scan all projects for tests and ports:

prx scan

This scans every project and updates:

  • Test files
  • Port information
  • Framework detection

Running Multiple Projects​

Start All Projects​

# Run all projects in background
prx 1 dev -M
prx 2 dev -M
prx 3 start -M
prx 4 dev -M

Check Running Processes​

prx ps

Shows all running background processes with:

  • Process IDs
  • Project names
  • Scripts running
  • Running time
  • Log file locations

Organizing Projects​

View with Ports​

prx list --ports

See detailed port information for all projects.

Filter by Port​

Use port information to avoid conflicts:

# List shows ports
prx list

# Check for conflicts before running
prx 1 dev  # Uses port 3000
prx 2 dev  # Uses port 3001 (no conflict)

Managing Background Processes​

Start Multiple​

prx 1 dev -M
prx 2 dev -M
prx 3 start -M

Stop All​

# Get PIDs
prx ps

# Stop each
prx stop 12345
prx stop 12346
prx stop 12347

Using Different Interfaces​

Terminal UI​

prx i

Navigate through all projects, scan, view details.

Desktop App​

prx web

Visual interface for managing all projects.

Workflow Example​

# Morning: Start all projects
prx 1 dev -M
prx 2 dev -M
prx 3 start -M

# Check status
prx ps
prx list

# Afternoon: Stop all
prx stop <pid1>
prx stop <pid2>
prx stop <pid3>

# Evening: Scan all for updates
prx scan

Tips​

Use Project IDs​

Project IDs are more reliable than names:

prx 1 dev    # Better
prx "Project 1" dev  # Works, but slower

Batch Operations​

Create shell functions for common operations:

prxstartall() {
  prx 1 dev -M
  prx 2 dev -M
  prx 3 start -M
}

prxstopall() {
  prx ps | grep -o 'PID [0-9]*' | awk '{print $2}' | xargs -I {} prx stop {}
}

Next Steps​