Project Manager CLI

A powerful CLI tool for managing and opening projects quickly.

Installation

npm install -g project-manager

Quick Start

1. Initialize the configuration:

pm init

2. List available projects:

pm list

3. Open a project:

pm open my-project
# or use the shortcut
pmo my-project

Features

🚀 Quick Project Access

• Open projects by name or alias
• Smart search with partial matching
• Interactive selection for multiple matches

🔧 Flexible Configuration

• Configurable editor (VS Code, Vim, etc.)
• Multiple base paths for project discovery
• Cross-platform support (Linux, macOS, Windows)

📋 Project Aliases

• Create shortcuts to frequently used projects
• Easy alias management
• Prioritized over project names

🔍 Smart Project Discovery

• Automatic discovery in configured paths
• Searches up to 2 levels deep
• Filters hidden directories

Commands

Init

Initialize project manager configuration:

pm init

Open Projects

Open a project by name or alias:

pm open <name>        # Open project by name/alias
pmo <name>            # Shortcut for pm open

Alias Management

pm alias add <alias> <path>     # Add project alias
pm alias remove <alias>         # Remove alias  
pm alias list                   # List all aliases

List Projects

pm list               # List all projects and aliases

Configuration

pm config                       # Show current config
pm config editor <editor>       # Set default editor
pm config basePath <path>       # Set base path

Configuration

The configuration is stored in ~/.pm/config.json :

{
  "editor": "code",
  "basePaths": ["~/Developer/projects"],
  "aliases": {
    "myapp": "/path/to/my-app"
  },
  "projects": {}
}

Supported Editors

• code - Visual Studio Code
• vim - Vim
• nvim - Neovim
• subl - Sublime Text
• atom - Atom
• Any other editor command

Examples

# Initialize
pm init

# Add an alias
pm alias add myapp ~/projects/my-awesome-app

# Open by alias
pm open myapp
pmo myapp

# Open by project name (partial match)
pm open awe    # Will find "my-awesome-app"

# List everything
pm list

# Change editor
pm config editor vim

# Show configuration
pm config

Requirements

• Node.js 16 or higher
• Your preferred editor installed and available in PATH

License

ISC