Mess Project Manager

A comprehensive Visual Studio Code extension for developers who juggle multiple projects. Organize, manage, and access your projects with advanced features including Git integration, terminal shortcuts, and a powerful Notes & Commands system.

✨ Key Features

📁 Advanced Project Management

Multiple Views: Switch between All Projects, Categorized, Git, and Notes views
Drag & Drop: Intuitive reordering and categorization
Smart Detection: Automatically identifies 15+ project types (React, Vue, Angular, Node.js, Python, Docker, etc.)
Quick Access: One-click opening in new window, current window, or file explorer

🏷️ Organization & Categorization

Custom Categories: Create unlimited categories with custom icons
Favorites System: Star important projects for quick access
Advanced Search: Filter projects by name, path, or content in real-time
Active/Inactive Toggle: Show/hide inactive projects as needed

🔄 Git Integration

Repository Detection: Automatically finds and tracks Git repositories
Branch Information: View current branch and sync status
Change Indicators: Visual indicators for uncommitted changes
Git Operations: Pull repositories and view status directly from the tree
Clone Support: Clone new repositories with built-in dialog

🖥️ Terminal Integration

Multi-Terminal Support: Access CMD, PowerShell, Git Bash, and integrated terminal
Admin Mode: Run terminals with elevated privileges when needed
Smart Menu: Platform-aware terminal selection (Windows/macOS/Linux)
Quick Launch: Right-click any project to open terminal in its directory

📝 Notes & Commands System (Enhanced in v0.3.2)

Useful Tips Sheet: 100+ ready-to-use commands for Git, NPM, Docker, Python, and more
Smart Descriptions: Commands show helpful descriptions using # separator format
Auto-Refresh: Tips sheet updates automatically with latest commands on startup
Sheet-Based Organization: Create multiple note sheets for different contexts
Command Management: Store and run frequently used commands with one click
Quick Copy & Run: Copy commands to clipboard or execute directly
Educational: Perfect for learning new tools or onboarding developers

📦 Installation

From VS Code Marketplace

Open VS Code
Go to Extensions (Ctrl+Shift+X / Cmd+Shift+X)
Search for "Mess Project Manager"
Click Install

Manual Installation

# Clone repository
git clone https://github.com/MinhMuix2908/mess-project-manager.git
cd mess-project-manager

# Install dependencies
npm install

# Compile extension
npm run compile

# Package for installation
npm install -g vsce
vsce package

🚀 Quick Start Guide

1. Adding Projects

Quick Save: Click the ➕ button while any project is open
Manual Config: Click the ✏️ button to edit projects.json directly

2. Using Categories

Create: Right-click in Categories view → "Add Category"
Assign: Drag projects to categories or use right-click menu
Organize: Use favorites and custom categories for better organization

3. Git Integration

Auto-Detection: Git repos appear automatically in Git view
Quick Operations: Right-click for pull, status, and terminal access
Clone Repos: Use the clone button to add new repositories

4. Terminal Access

Right-Click Menu: Access "Terminal Menu" on any project
Quick Terminal: Click terminal icon for integrated terminal
Admin Access: Available for Windows CMD and PowerShell

5. Notes & Commands (Enhanced in v0.3.2!)

Instant Commands: Access 100+ pre-loaded commands in the "Useful Tips" sheet
Smart Format: Commands with descriptions using # description format
Create Sheets: Click ➕ in Notes view to create custom sheets

Edit Structure: Open any sheet to edit using this format:

Sheet Name

    Header Name
        > git status # Check repository status and changes
        > npm install # Install all dependencies from package.json
        Regular note text without description

Copy & Run: Right-click notes to copy or execute commands directly

📋 Notes & Commands Format

The Notes system uses a simple indentation-based format:

My Development Sheet

    Git Commands
        > git status # Check repository status and changes
        > git add . # Stage all changes for commit
        > git commit -m "Update" # Commit staged changes with message
        Remember to check staging area first
        
    Node.js Commands  
        > npm install # Install all dependencies from package.json
        > npm run dev # Start development server
        > npm run build # Build the project for production
        Use --force flag if needed

Rules:

Sheet Name: First line (no indentation)
Headers: 4 spaces indentation
Commands: 8 spaces + > prefix + optional # description
Notes: 8 spaces (no > prefix)
Descriptions: Use # text at end of commands for helpful explanations

⚙️ Configuration

Extension Settings

{
  "messProjectManager.showInactiveProjects": false
}

Project Configuration

Projects are stored in projects.json:

{
  "projects": [
    {
      "label": "E-commerce Site",
      "path": "/path/to/project",
      "active": true,
      "category": "work",
      "favorite": true
    }
  ]
}

🎮 Available Commands

Access via Command Palette (Ctrl+Shift+P / Cmd+Shift+P):

Project Management

Mess Project Manager: Save Current Location
Mess Project Manager: Edit Projects Config
Mess Project Manager: Refresh Projects
Mess Project Manager: Search Projects

Git Operations

Mess Project Manager: Refresh Git Projects
Mess Project Manager: Clone Repository

Notes & Commands

Mess Project Manager: Add Sheet
Mess Project Manager: Refresh Notes

Terminal Access

Multiple terminal options available via context menus

📱 Supported Project Types

The extension automatically detects and provides appropriate icons for:

Frontend: React, Vue, Angular, Svelte
Backend: Node.js, Python, Java, C#, PHP, Go, Ruby
Mobile: Flutter/Dart
DevOps: Docker
Others: Unity, Git repositories, general projects

🛠️ Development

Prerequisites

Node.js 20.x+
VS Code 1.90.0+
TypeScript 5.x

Development Setup

git clone https://github.com/MinhMuix2908/mess-project-manager.git
cd mess-project-manager
npm install
npm run compile
npm run watch  # For development

Building

npm run vscode:prepublish  # Production build
vsce package              # Create .vsix file

🔧 What's New in v0.3.2

🚀 Latest Updates

Enhanced Useful Tips: 100+ commands across Git, NPM/Yarn, Docker, Python, databases, and system operations
Smart Descriptions: Commands now show helpful descriptions instead of generic "Command/Note" labels
Auto-Refresh Tips: Useful Tips sheet automatically updates with latest content on every startup
Fixed Extension Icon: Proper marketplace icon display for better discoverability
Improved Click Behavior: ProjectItem onClick now properly opens projects in current window

📚 New Command Categories

Git Operations: 25+ essential git commands with clear explanations
Development Tools: NPM/Yarn, Docker, Python virtual environments
System Commands: File operations for both Linux/Mac and Windows
Database Connections: PostgreSQL, MySQL, MongoDB, Redis, SQLite
Best Practices: Development notes and useful resource links

🔧 Previous Updates - v0.3.1

🎯 Version 0.3.1

Version 0.3.1: Stability improvements and documentation updates
Enhanced Performance: Optimized extension loading and refresh operations
Better Documentation: Comprehensive guides and troubleshooting sections

🔧 Previous Updates - v0.0.2

✨ Major Features Added

Notes & Commands System: Complete sheet-based note management
Terminal Integration: Multi-platform terminal support with admin mode
Enhanced Git: Pull operations and status viewing
Improved UI: Better icons and context menus

🐛 Fixes & Improvements

Simplified file-based storage for better reliability
Removed complex document tracking that caused save issues
Streamlined refresh logic for better performance
Cleaner command structure and menu organization

🚀 Technical Improvements

Pure file-based system for notes (no more JSON complexity)
Auto-generated sheet IDs for better organization
Improved error handling and user feedback
Better TypeScript typing and code organization

🐛 Troubleshooting

Common Issues

Projects not appearing?

Verify paths exist and are accessible
Check if projects are marked as active: true
Try refreshing the view

Git features not working?

Ensure Git is installed and in PATH
Check that projects have .git directories
Verify remote repositories are configured

Terminal not opening?

Check platform-specific terminal availability
Try different terminal types from the menu
Verify admin permissions for elevated terminals

Notes not saving properly?

Ensure sheets folder exists and is writable
Check file permissions in VS Code global storage
Try refreshing the Notes view

🔮 Roadmap

Planned Features

Advanced Git: Branch switching, merge operations
Package Manager: npm/yarn command shortcuts
Project Templates: Quick project scaffolding
Cloud Sync: Sync settings across devices
Enhanced Search: Global search across all notes and projects
Workspace Integration: Better multi-root workspace support

📄 License

MIT License - see LICENSE.md for details.

🤝 Contributing

Contributions welcome! Please:

Fork the repository
Create a feature branch
Submit a Pull Request

See our Contributing Guidelines for details.

📊 Extension Info

Version: 0.3.2
Publisher: DaoQuangMinh
Repository: GitHub
VS Code: ^1.90.0
License: MIT

📞 Support

Issues: GitHub Issues
Email: daoquangminh2908@gmail.com
Discussions: GitHub Discussions

Made with ❤️ for developers everywhere

Mess Project Manager

Dao Quang Minh

Mess Project Manager

✨ Key Features

📁 Advanced Project Management

🏷️ Organization & Categorization

🔄 Git Integration

🖥️ Terminal Integration

📝 Notes & Commands System (Enhanced in v0.3.2)

📦 Installation

From VS Code Marketplace

Manual Installation

🚀 Quick Start Guide

1. Adding Projects

2. Using Categories

3. Git Integration

4. Terminal Access

5. Notes & Commands (Enhanced in v0.3.2!)

📋 Notes & Commands Format

⚙️ Configuration

Extension Settings

Project Configuration

🎮 Available Commands

Project Management

Git Operations

Notes & Commands

Terminal Access

📱 Supported Project Types

🛠️ Development

Prerequisites

Development Setup

Building

🔧 What's New in v0.3.2

🚀 Latest Updates

📚 New Command Categories

🔧 Previous Updates - v0.3.1

🎯 Version 0.3.1

🔧 Previous Updates - v0.0.2

✨ Major Features Added

🐛 Fixes & Improvements

🚀 Technical Improvements

🐛 Troubleshooting

Common Issues

🔮 Roadmap

Planned Features

📄 License

🤝 Contributing

📊 Extension Info

📞 Support