Project Manager (pm)

A simple and efficient way to manage your local project files directly within VS Code.

Features

Project Management:
- Create new projects with customizable scaffolds.
- Open existing projects in the current or a new window.
- Delete projects (moves to trash by default).
- Quickly open projects from a list of all available projects or recently opened ones.
Workspace Management:
- Create and open multi-project workspaces.
- Quickly open existing workspaces.
- Close the current workspace or folder.
Dependency Management:
- Clean project dependencies based on configurable glob patterns (e.g., node_modules, target).
Git Integration:
- Clone remote repositories directly into your project structure.

Getting Started

Install the Extension: Search for "pm" in the VS Code Extensions view and click Install.
Configure the Root Directory: Open your settings.json file and set the ProjectManager.root property to the absolute path of your projects' root folder.
```
{
  "ProjectManager.root": "/path/to/your/projects"
}
```

Usage

Open the Command Palette (Ctrl+Shift+P or Cmd+Shift+P) and type pm to see all available commands.

Available Commands

pm: New Project: Creates a new project in a selected category.
pm: Open Project: Opens an existing project.
pm: Delete Project: Deletes one or more projects.
pm: Quick Opening Project: Quickly opens a project from a list of recent and all projects.
pm: Clone Remote Repository: Clones a Git repository into a selected category.
pm: Delete Project Dependencies: Deletes dependency folders (e.g., node_modules) from selected projects.
pm: Create And Open Workspace: Creates a new workspace with selected projects.
pm: Quick Open Workspace: Quickly opens an existing workspace.
pm: Close Workspace Or Folder: Closes the currently open workspace or folder.

Configuration

You can customize the extension's behavior by modifying the following settings in your settings.json file:

ProjectManager.root (required):
- The absolute path to the root folder where your projects are stored.
- Example: "/home/user/projects" or "D:\\Projects"
ProjectManager.category:
- An array of strings representing your project categories. These categories will be used to organize your projects in subdirectories.
- Default: []
- Example: ["Vue", "React", "Node", "Python"]
ProjectManager.scaffolds:
- An object where keys are scaffold names and values are the commands to execute for creating a new project.
- Default: {}
- Example:
```
{
  "create-vite": "npx create-vite .",
  "create-next-app": "npx create-next-app@latest ."
}
```
ProjectManager.cleanerPatterns:
- An array of glob patterns for folders to be deleted by the 'Delete Project Dependencies' command.
- Default: ["**/node_modules", "**/target", "**/.venv"]

Example Configuration

{
  "window.dialogStyle": "custom", // Recommended for a better user experience
  "ProjectManager.root": "D:\\Projects",
  "ProjectManager.category": [
    "Vue",
    "React",
    "Node",
    "Python",
    "Rust",
    "Go"
  ],
  "ProjectManager.scaffolds": {
    "Vite": "npx create-vite .",
    "Next.js": "npx create-next-app@latest ."
  },
  "ProjectManager.cleanerPatterns": [
    "**/node_modules",
    "**/target",
    "**/.venv",
    "**/build"
  ]
}

Contributing

Contributions are welcome! Please feel free to open an issue or submit a pull request on GitHub.

Enjoy!

pm

akirco