PMM Cursor Tools

A VS Code extension for managing Tomcat development workflow, including server management, hot reloading, Maven operations, ngrok tunneling, and real-time log streaming.

Features

🚀 Tomcat Management

• Start/Stop/Debug Tomcat - Full lifecycle management from the status bar
• Port monitoring - Automatically detects if Tomcat is running on port 8080
• Visual status indicators - Blue background when Tomcat is active
• Debug attachment - One-click debugger attachment on port 8000

🔄 Hot Reload

• Maven compilation - Compiles Java sources with proper compiler settings
• File synchronization - Syncs compiled classes and web content to deployment directory
• Progress tracking - Visual progress indicators during hot reload process
• Background color feedback - Status bar changes color during operations

🔧 Maven Operations

• Spotbugs analysis - Runs static code analysis with failure on errors
• Selector generation - Generates UI selectors via npm scripts
• Common constants/enums generation - Auto-generates TypeScript constants from Java files
• Quick access menu - All Maven operations in one convenient menu

🌐 Ngrok Integration

• One-click tunneling - Toggle ngrok tunnel on/off
• Automatic URL generation - Creates public URL with webapp path appended
• Clipboard integration - Automatically copies tunnel URL to clipboard
• Visual status indicators - Status bar shows tunnel state and URL

📋 Real-time Log Streaming

• Live Tomcat logs - Streams catalina.out in real-time
• Color-coded levels - Different colors for ERROR, WARN, INFO, DEBUG, etc.
• Smart filtering - Recognizes exception traces, startup/shutdown events
• Timestamp integration - Adds local timestamps to log entries

Requirements

• Java Development Kit - For running Tomcat and Maven
• Apache Tomcat - Configured and accessible via settings
• Maven - For building and analysis operations
• Node.js/npm - For selector and constant generation scripts
• ngrok (optional) - For tunneling functionality

Extension Settings

This extension contributes the following settings:

• pmm-cursor-tools.tomcatPath: Path to Tomcat installation directory
• pmm-cursor-tools.webappName: Name of the webapp for deployment
• pmm-cursor-tools.debugPort: Debug port for Tomcat (default: 8000)

Usage

Setup

1. Configure pmm-cursor-tools.tomcatPath in VS Code settings
2. Configure pmm-cursor-tools.webappName for your project
3. Ensure Maven and npm are available in your PATH

Status Bar Controls

The extension adds several status bar items:

• Tomcat - Server management (start/stop/debug)
• Hot Reload - Compile and sync changes
• Maven - Build operations and code generation
• Ngrok - Public tunnel management

Log Monitoring

• The "Tomcat Logs" output channel automatically appears
• Real-time streaming with color-coded log levels
• Automatic startup when extension activates

Release Notes

0.0.1

Initial release with complete Tomcat development workflow support.

Enjoy efficient Tomcat development!