pomera-ai-commander 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 MatBanik
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,680 @@
+# Pomera AI Commander
+
+A comprehensive text processing GUI application built with Python and Tkinter, featuring advanced performance monitoring, intelligent caching, and AI-powered tools.
+
+[![Download Latest Release](https://img.shields.io/badge/Download-Latest%20Release-blue?style=for-the-badge&logo=github)](https://github.com/matbanik/Pomera-AI-Commander/releases)
+
+## 📸 Screenshots
+
+<div align="center">
+
+![Pomera AI Commander Screenshot 1](./PAC1.jpg)
+*Main interface with multi-tab text processing*
+
+![Pomera AI Commander Screenshot 2](./PAC2.jpg)
+*Advanced tools and AI integration*
+
+![Pomera AI Commander Screenshot 3](./PAC3.jpg)
+*Diff viewer with side-by-side comparison*
+
+![Pomera AI Commander Screenshot 4](./PAC4.jpg)
+*Performance monitoring dashboard*
+
+![Pomera AI Commander Screenshot 5](./PAC5.jpg)
+*Text statistics and analysis tools*
+
+![Pomera AI Commander Screenshot 6](./PAC6.jpg)
+*Export capabilities and format options*
+
+![Pomera AI Commander Screenshot 7](./PAC7.jpg)
+*Settings and configuration panel*
+
+</div>
+
+## 📚 Documentation
+
+### Quick Links
+- **[Tools Documentation](docs/TOOLS_DOCUMENTATION.md)** - Comprehensive guide to all available tools
+- **[MCP Server Guide](#troubleshooting-mcp-integration)** - MCP server setup and integration
+- **[Troubleshooting Guide](docs/TROUBLESHOOTING.md)** - Solutions for common issues
+- **[Release Process Guide](docs/RELEASE_PROCESS.md)** - Detailed release procedures for maintainers
+- **[Release Testing Guide](docs/RELEASE_TESTING.md)** - Testing procedures for releases
+- **[Testing Quick Start Guide](docs/TESTING_QUICK_START.md)** - Rapid testing setup and procedures
+
+## 🚀 Features
+
+### Core Text Processing
+- **Multi-tab Interface** - Work with multiple text inputs and outputs simultaneously
+- **Advanced Find & Replace** - Powerful text search and replacement with regex support
+- **Case Conversion Tools** - Sentence case, title case, upper/lower case transformations
+- **Text Statistics** - Real-time byte, word, line, and paragraph counting
+- **Export Capabilities** - Save to TXT, CSV, PDF, and DOCX formats
+
+### Advanced Tools
+- **Email Processing** - Extract and analyze email addresses and headers
+- **URL Tools** - Extract URLs and parse URL components
+- **Code Utilities** - Base64 encoding/decoding, binary translation, Morse code
+- **Text Generators** - Password generation, repeating text, alphabetical sorting
+- **Diff Viewer** - Side-by-side text comparison with word-level highlighting
+
+### AI Integration
+- **AI Tools Widget** - Integrated AI-powered text processing capabilities
+- **Multiple AI Providers** - Support for various AI services and models
+- **Smart Processing** - Context-aware text analysis and transformation
+
+### MCP Server (Model Context Protocol)
+- **Expose Tools to AI Assistants** - Run Pomera as an MCP server for AI IDE integration
+- **33 Text Processing Tools** - All major tools available via MCP protocol
+- **Notes Database** - Store, retrieve, and search notes via MCP
+- **Multiple Transports** - stdio transport for seamless subprocess integration
+- **Works with Cursor, Claude Desktop** - Compatible with any MCP-enabled client
+
+### Performance Features
+- **Intelligent Caching** - Smart caching system for improved performance
+- **Async Processing** - Non-blocking text processing for large files
+- **Progressive Search** - Optimized search with real-time highlighting
+- **Memory Optimization** - Efficient memory usage for large text files
+- **Performance Monitoring** - Built-in performance tracking and optimization
+
+## 🛠️ Installation
+
+### Prerequisites
+- Python 3.8 or higher
+- Required Python packages (install via pip):
+
+```bash
+pip install tkinter requests reportlab python-docx
+```
+
+### Optional Dependencies
+For enhanced functionality:
+```bash
+pip install pyaudio numpy psutil huggingface-hub
+```
+
+### Quick Start
+
+#### Option 1: Download Pre-built Executable (Recommended)
+
+1. Go to the [**Releases page**](https://github.com/matbanik/Pomera-AI-Commander/releases)
+2. Download the latest version for your platform:
+   - **Windows**: `pomera-v1.0.0-windows.exe`
+   - **Linux**: `pomera-v1.0.0-linux`
+   - **macOS (Apple Silicon)**: `pomera-v1.0.0-macos-arm64`
+3. Run the executable directly (no Python installation required)
+
+#### Option 2: Run from Source
+1. Clone the repository:
+```bash
+git clone https://github.com/matbanik/Pomera-AI-Commander.git
+cd Pomera-AI-Commander
+```
+
+2. Run the application:
+```bash
+python pomera.py
+```
+
+## 📦 Releases and Downloads
+
+### Getting the Latest Release
+
+Visit the [**Releases page**](https://github.com/matbanik/Pomera-AI-Commander/releases) to download pre-built executables for your platform. Each release includes:
+
+- **Cross-platform executables** - No Python installation required
+- **SHA256 checksums** - For security verification
+- **Release notes** - What's new and changed
+- **Installation instructions** - Platform-specific setup guides
+
+### Platform-Specific Installation
+
+#### Windows
+1. Download `pomera-v1.0.0-windows.exe`
+2. **Optional**: Verify the download using SHA256 checksum from `checksums.txt`
+3. Double-click the executable to run
+4. **Note**: Windows may show a security warning for unsigned executables - click "More info" → "Run anyway"
+
+#### Linux
+1. Download `pomera-v1.0.0-linux`
+2. Make executable and run:
+   ```bash
+   chmod +x pomera-v1.0.0-linux
+   ./pomera-v1.0.0-linux
+   ```
+
+#### macOS
+
+**Apple Silicon Macs (M1/M2/M3/M4)**:
+1. Download `pomera-v1.0.0-macos-arm64`
+2. Make executable and run:
+   ```bash
+   chmod +x pomera-v1.0.0-macos-arm64
+   ./pomera-v1.0.0-macos-arm64
+   ```
+3. **Note**: macOS may require allowing the app in System Preferences → Security & Privacy
+
+### Release Process (For Maintainers)
+
+#### Triggering a Release
+1. **Create a version tag** following semantic versioning:
+   ```bash
+   git tag v1.0.0
+   git push origin v1.0.0
+   ```
+2. **GitHub Actions automatically**:
+   - Builds executables for Windows, Linux, and macOS
+   - Generates SHA256 checksums
+   - Creates a GitHub release
+   - Uploads all artifacts
+
+#### Version Tag Format
+- Use semantic versioning: `v1.0.0`, `v1.2.3`, `v2.0.0-beta.1`
+- Tags must start with `v` to trigger the release workflow
+- Pre-release tags (containing `-alpha`, `-beta`, `-rc`) create pre-releases
+
+#### Release Workflow
+```mermaid
+graph LR
+    A[Push version tag] --> B[GitHub Actions triggers]
+    B --> C[Build on 3 platforms]
+    C --> D[Generate checksums]
+    D --> E[Create GitHub release]
+    E --> F[Upload artifacts]
+```
+
+### Troubleshooting Downloads
+
+#### Common Issues
+
+**Windows: "Windows protected your PC" warning**
+- This is normal for unsigned executables
+- Click "More info" → "Run anyway"
+- Alternative: Run from source if you prefer
+
+**Linux/macOS: "Permission denied" error**
+- The executable needs execute permissions
+- Run: `chmod +x pomera-v1.0.0-linux` (or macos)
+
+**macOS: "App can't be opened because it is from an unidentified developer"**
+- Go to System Preferences → Security & Privacy
+- Click "Open Anyway" next to the blocked app message
+- Alternative: Run `xattr -d com.apple.quarantine pomera-v1.0.0-macos-arm64`
+
+**Download verification fails**
+- Re-download the file (may be corrupted)
+- Check you're comparing against the correct checksum from `checksums.txt`
+- Ensure you downloaded the checksum file from the same release
+
+**Executable won't start**
+- Check system requirements (64-bit OS)
+- Try running from command line to see error messages
+- For older systems, try running from source instead
+
+#### Getting Help
+- Check the [Troubleshooting Guide](docs/TROUBLESHOOTING.md) for detailed solutions
+- Search [existing issues](https://github.com/matbanik/Pomera-AI-Commander/issues) for known problems
+- Create a new issue with:
+  - Your operating system and version
+  - The exact error message
+  - Steps you tried to resolve it
+
+Pomera-AI-Commander/
+├── pomera.py                 # Main application (supports --mcp-server flag)
+├── tools/                    # All tool modules
+│   ├── __init__.py
+│   ├── ai_tools.py
+│   ├── base64_tools.py
+│   ├── case_tool.py
+│   ├── diff_viewer.py
+│   ├── email_extraction_tool.py
+│   ├── email_header_analyzer.py
+│   ├── find_replace.py
+│   ├── generator_tools.py
+│   ├── list_comparator.py
+│   ├── mcp_widget.py         # MCP Manager UI
+│   ├── sorter_tools.py
+│   ├── translator_tools.py
+│   ├── url_link_extractor.py
+│   ├── url_parser.py
+│   └── word_frequency_counter.py
+├── core/                     # All core utility modules
+│   ├── __init__.py
+│   ├── async_text_processor.py
+│   ├── content_hash_cache.py
+│   ├── mcp/                  # MCP Server implementation
+│   │   ├── __init__.py
+│   │   ├── schema.py         # MCP message schemas
+│   │   ├── protocol.py       # JSON-RPC protocol handling
+│   │   ├── tool_registry.py  # Tool registration and adapters
+│   │   └── server_stdio.py   # stdio transport server
+│   ├── memory_efficient_text_widget.py
+│   ├── optimized_find_replace.py
+│   └── [other modules...]
+└── docs/
+    ├── MCP_PROJECT.md        # MCP server documentation
+    └── MCP_TASKS.md          # MCP implementation status
+
+
+## 📖 Usage
+
+### Basic Text Processing
+1. **Input Text** - Enter or paste text in the input tabs
+2. **Select Tool** - Choose from the dropdown menu of available tools
+3. **Process** - Click "Apply Tool" or use automatic processing
+4. **View Results** - See processed text in the output tabs
+5. **Export** - Save results in your preferred format
+
+### Comprehensive Tool Documentation
+For detailed information about all available tools, features, and usage examples, see the [**Tools Documentation**](docs/TOOLS_DOCUMENTATION.md).
+
+### Advanced Features
+- **Diff Viewer** - Compare two texts side-by-side with highlighting
+- **Performance Dashboard** - Monitor application performance and optimize settings
+- **AI Tools** - Access AI-powered text processing capabilities
+- **Batch Processing** - Process multiple texts efficiently
+- **MCP Manager** - Configure and test MCP server integration (Widgets → MCP Manager)
+
+### Keyboard Shortcuts
+- `Ctrl+Z` / `Ctrl+Y` - Undo/Redo
+- `Ctrl+S` - Save settings
+- `Ctrl+O` - Open file
+- `Ctrl+E` - Export current output
+- `Ctrl+M` - Open MCP Manager
+
+## ⚙️ Configuration
+
+### Settings
+The application automatically saves settings to `settings.json`, including:
+- Tool preferences and configurations
+- Performance optimization settings
+- UI layout and preferences
+- Export paths and formats
+
+### Performance Optimization
+- **Automatic Mode** - Intelligent performance adjustments based on content size
+- **Manual Mode** - Fine-tune performance settings for your system
+- **Memory Management** - Optimize memory usage for large files
+- **Async Processing** - Enable background processing for better responsiveness
+
+## 🔌 MCP Server Integration
+
+Pomera can run as an MCP (Model Context Protocol) server, exposing all its text processing tools to AI assistants like Cursor, Claude Desktop, or any MCP-compatible client.
+
+### Quick Setup for Cursor
+
+1. Open MCP Manager: `Widgets → MCP Manager` or `Ctrl+M`
+2. Go to the **Configuration** tab
+3. Copy the JSON configuration
+4. Add it to your Cursor MCP settings (`~/.cursor/mcp.json`)
+
+### Running as MCP Server
+
+```bash
+# From source
+python pomera.py --mcp-server
+
+# From compiled executable
+pomera.exe --mcp-server
+```
+
+### Available MCP Tools (33 total)
+
+| Category | Tools |
+|----------|-------|
+| **Text Transform** | `pomera_case_transform`, `pomera_whitespace`, `pomera_line_tools`, `pomera_sort` |
+| **Encoding** | `pomera_base64`, `pomera_hash`, `pomera_string_escape`, `pomera_slug` |
+| **Data Formats** | `pomera_json_xml`, `pomera_markdown`, `pomera_column_tools` |
+| **Extraction** | `pomera_regex_extract`, `pomera_extract_emails`, `pomera_extract_urls`, `pomera_html`, `pomera_email_header_analyzer` |
+| **Utilities** | `pomera_url_parse`, `pomera_timestamp`, `pomera_cron`, `pomera_number_base`, `pomera_text_wrap`, `pomera_text_stats`, `pomera_word_frequency`, `pomera_list_compare` |
+| **Generators** | `pomera_generators`, `pomera_translator` |
+| **Notes** | `pomera_notes_save`, `pomera_notes_get`, `pomera_notes_list`, `pomera_notes_search`, `pomera_notes_update`, `pomera_notes_delete` |
+
+### MCP Configuration Example
+
+```json
+{
+  "mcpServers": {
+    "pomera": {
+      "command": "python",
+      "args": ["C:/path/to/pomera.py", "--mcp-server"]
+    }
+  }
+}
+```
+
+For detailed MCP documentation, see [**MCP Server Guide**](docs/MCP_PROJECT.md).
+
+### Setting Up Pomera MCP Server with Cursor
+
+Cursor IDE supports MCP servers natively. Follow these steps to integrate Pomera:
+
+#### Step 1: Locate Your MCP Configuration File
+
+**Windows:**
+```
+%USERPROFILE%\.cursor\mcp.json
+```
+Example: `C:\Users\YourName\.cursor\mcp.json`
+
+**macOS:**
+```
+~/.cursor/mcp.json
+```
+
+**Linux:**
+```
+~/.cursor/mcp.json
+```
+
+#### Step 2: Add Pomera to MCP Configuration
+
+Open or create the `mcp.json` file and add the Pomera server configuration:
+
+**Using Python (from source):**
+```json
+{
+  "mcpServers": {
+    "pomera": {
+      "command": "python",
+      "args": ["C:/path/to/Pomera-AI-Commander/pomera.py", "--mcp-server"]
+    }
+  }
+}
+```
+
+**Using Compiled Executable (Windows):**
+```json
+{
+  "mcpServers": {
+    "pomera": {
+      "command": "C:/path/to/pomera.exe",
+      "args": ["--mcp-server"]
+    }
+  }
+}
+```
+
+**Using Compiled Executable (Linux/macOS):**
+```json
+{
+  "mcpServers": {
+    "pomera": {
+      "command": "/path/to/pomera",
+      "args": ["--mcp-server"]
+    }
+  }
+}
+```
+
+#### Step 3: Restart Cursor
+
+After saving the configuration, restart Cursor IDE for the changes to take effect.
+
+#### Step 4: Verify the Connection
+
+1. Open Cursor's MCP panel (usually in settings or via command palette)
+2. You should see "pomera" listed as an available server
+3. The 33 Pomera tools will be available to the AI assistant
+
+#### Using Pomera Tools in Cursor
+
+Once configured, you can ask Cursor's AI to use Pomera tools:
+
+```
+"Use pomera_case_transform to convert this text to title case"
+"Hash this text using pomera_hash with SHA256"
+"Extract all URLs from this document using pomera_extract_urls"
+"Save this as a note using pomera_notes_save"
+```
+
+### Setting Up Pomera MCP Server with Visual Studio Code
+
+VS Code requires the [MCP extension](https://marketplace.visualstudio.com/items?itemName=anthropics.claude-mcp) or a compatible AI extension that supports MCP.
+
+#### Step 1: Install MCP Extension
+
+1. Open VS Code
+2. Go to Extensions (`Ctrl+Shift+X`)
+3. Search for "MCP" or "Claude MCP"
+4. Install the official MCP extension
+
+#### Step 2: Configure the MCP Server
+
+**Option A: Using VS Code Settings (settings.json)**
+
+Open your VS Code settings (`Ctrl+,` → Open Settings JSON) and add:
+
+```json
+{
+  "mcp.servers": {
+    "pomera": {
+      "command": "python",
+      "args": ["C:/path/to/Pomera-AI-Commander/pomera.py", "--mcp-server"]
+    }
+  }
+}
+```
+
+**Option B: Using Workspace Configuration**
+
+Create a `.vscode/mcp.json` file in your workspace:
+
+```json
+{
+  "servers": {
+    "pomera": {
+      "command": "python",
+      "args": ["${workspaceFolder}/../Pomera-AI-Commander/pomera.py", "--mcp-server"]
+    }
+  }
+}
+```
+
+#### Step 3: Reload VS Code
+
+Use `Ctrl+Shift+P` → "Developer: Reload Window" to apply the configuration.
+
+### Setting Up with Claude Desktop
+
+Claude Desktop also supports MCP servers. Add Pomera to your Claude configuration:
+
+**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "pomera": {
+      "command": "python",
+      "args": ["C:/path/to/Pomera-AI-Commander/pomera.py", "--mcp-server"]
+    }
+  }
+}
+```
+
+### Troubleshooting MCP Integration
+
+#### Server Not Starting
+
+1. **Check the path**: Ensure the path to `pomera.py` or the executable is correct
+2. **Check Python**: Make sure Python is in your system PATH
+3. **Test manually**: Run `python pomera.py --mcp-server` in terminal to see errors
+
+#### Tools Not Appearing
+
+1. **Restart the IDE**: Sometimes a full restart is needed
+2. **Check logs**: Look for MCP-related errors in the IDE's developer console
+3. **Verify JSON syntax**: Ensure your configuration file has valid JSON
+
+#### Permission Issues (Linux/macOS)
+
+```bash
+# Make the executable runnable
+chmod +x /path/to/pomera
+
+# If using Python, ensure it's accessible
+which python
+```
+
+#### Common Error Messages
+
+| Error | Solution |
+|-------|----------|
+| "Command not found" | Check the command path, ensure Python/executable is in PATH |
+| "Connection refused" | Server crashed on startup, check logs |
+| "Invalid JSON" | Fix syntax errors in your mcp.json file |
+| "Permission denied" | Add execute permissions to the file |
+
+### MCP Server Logs
+
+To debug issues, you can check the MCP server logs:
+
+```bash
+# Run with verbose output
+python pomera.py --mcp-server 2>&1 | tee mcp_debug.log
+```
+
+The server logs are also written to `mcp_filesystem.log` in the Pomera directory.
+
+## 🏗️ Architecture
+
+### Core Components
+- **Main Application** (`pomera.py`) - Primary GUI and application logic
+- **Text Processors** - Specialized modules for different text operations
+- **Performance System** - Monitoring, caching, and optimization components
+- **AI Integration** - AI tools and provider interfaces
+
+### Performance Optimizations
+- **Lazy Loading** - Modules loaded only when needed
+- **Intelligent Caching** - Smart caching for frequently used operations
+- **Async Processing** - Non-blocking operations for large files
+- **Memory Efficiency** - Optimized memory usage patterns
+
+## 🧪 Testing
+
+For quick testing setup and procedures, see the [**Testing Quick Start Guide**](docs/TESTING_QUICK_START.md).
+
+### Test Coverage
+- **Functionality Tests** - Core feature validation
+- **Performance Tests** - Startup time and memory usage
+- **Integration Tests** - AI tools and external service integration
+- **Regression Tests** - Ensure optimizations don't break functionality
+
+## 📊 Performance
+
+### Benchmarks
+- **Startup Time** - Optimized to ~0.47 seconds
+- **Memory Usage** - Efficient memory management with lazy loading
+- **Processing Speed** - Async processing for large files
+- **Responsiveness** - Non-blocking UI operations
+
+### Optimization Features
+- **Smart Caching** - Intelligent result caching
+- **Lazy Loading** - Modules loaded on-demand
+- **Memory Pools** - Efficient memory allocation
+- **Background Processing** - Non-blocking operations
+
+## 🤝 Contributing
+
+### Development Setup
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Run the validation framework
+5. Submit a pull request
+
+### Code Style
+- Follow PEP 8 guidelines
+- Use type hints where appropriate
+- Include docstrings for functions and classes
+- Maintain test coverage for new features
+
+### Performance Considerations
+- Profile performance impact of changes
+- Use lazy loading for optional features
+- Implement proper error handling
+- Consider memory usage implications
+
+### Release Process (Maintainers)
+
+#### Creating a Release
+1. **Prepare the release**:
+   - Ensure all changes are merged to main branch
+   - Update version numbers if needed
+   - Test the application thoroughly
+
+2. **Create and push a version tag**:
+   ```bash
+   git tag v1.0.0
+   git push origin v1.0.0
+   ```
+
+3. **Automated build process**:
+   - GitHub Actions automatically builds executables for all platforms
+   - Creates GitHub release with generated release notes
+   - Uploads executables and checksums
+
+4. **Post-release verification**:
+   - Download and test executables from the release page
+   - Verify checksums match
+   - Update documentation if needed
+
+#### Version Numbering
+- Use semantic versioning: `v1.0.0`, `v1.2.3`, `v2.0.0`
+- Pre-releases: `v1.0.0-beta.1`, `v2.0.0-rc.1`
+- Tags must start with `v` to trigger the release workflow
+
+#### Release Testing
+- See [**Release Testing Guide**](docs/RELEASE_TESTING.md) for comprehensive testing procedures
+- See [**Release Process Guide**](docs/RELEASE_PROCESS.md) for detailed release procedures
+- See [**Testing Quick Start Guide**](docs/TESTING_QUICK_START.md) for rapid testing setup
+- Test on multiple platforms before tagging
+- Verify all core functionality works in built executables
+
+## 📝 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 🙏 Acknowledgments
+
+- Built with Python and Tkinter
+- AI integration powered by various AI service providers
+- Performance optimizations inspired by modern software engineering practices
+- Community feedback and contributions
+
+## 📞 Support
+
+### Documentation
+- **[Tools Documentation](docs/TOOLS_DOCUMENTATION.md)** - Comprehensive tool reference
+- **[Troubleshooting Guide](docs/TROUBLESHOOTING.md)** - Solutions for common issues
+- **[Release Testing Guide](docs/RELEASE_TESTING.md)** - Testing procedures
+- **[Release Process Guide](docs/RELEASE_PROCESS.md)** - Detailed release procedures
+- **[Testing Quick Start Guide](docs/TESTING_QUICK_START.md)** - Rapid testing setup
+- Check the built-in help system
+- Review the performance dashboard for optimization tips
+
+### Issues and Bug Reports
+- **Search existing issues** first: [GitHub Issues](https://github.com/matbanik/Pomera-AI-Commander/issues)
+- **Report bugs** with detailed information:
+  - Operating system and version
+  - Exact error messages
+  - Steps to reproduce the issue
+  - Expected vs actual behavior
+
+### Feature Requests
+- Submit feature requests via [GitHub Issues](https://github.com/matbanik/Pomera-AI-Commander/issues)
+- Use the "Feature Request" template
+- Describe the use case and expected behavior
+- Consider performance and compatibility implications
+
+### Getting Help
+1. **Check the troubleshooting guide** for common solutions
+2. **Search existing issues** to see if your problem is known
+3. **Create a detailed issue** if you can't find a solution
+4. **Join discussions** for general questions and community support
+
+---
+
+**Pomera AI Commander** - Empowering text processing with AI, performance optimization, and MCP server integration.
+
+*Last updated: December 2025*