# Gorev - Advanced Task Management & AI Integration for VS Code
<p align="center">
<img src="media/icon.png" alt="Gorev Logo" width="128" height="128">
</p>
<div align="center">
[๐บ๐ธ English](README.md) | [๐น๐ท Tรผrkรงe](README.tr.md)
[](https://marketplace.visualstudio.com/items?itemName=mehmetsenol.gorev-vscode)
[](https://marketplace.visualstudio.com/items?itemName=mehmetsenol.gorev-vscode)
[](https://marketplace.visualstudio.com/items?itemName=mehmetsenol.gorev-vscode)
[](LICENSE)
**The ultimate task management powerhouse with 24 optimized MCP tools (unified from 45), unlimited hierarchy, and seamless AI assistant integration**
> ๐ **NEW in v0.16.3**: Critical MCP Tool Fixes! 100% success rate for bulk operations, enhanced search query parsing, and VS Code dependency indicator fixes.
> ๐ **v0.16.2**: Automatic Server Startup! Zero-configuration - extension now starts server automatically. No manual commands needed!
> ๐ง **v0.16.0**: Complete REST API Migration! Type-safe JSON responses, enhanced error handling, and Web UI integration. No more markdown parsing - direct API communication for 3x better performance!
</div>
## ๐ Why Choose Gorev
Gorev transforms VS Code into a **professional task management powerhouse** with unique capabilities that set it apart:
- **๐ Zero-Installation NPX Setup** - Get started in seconds with no binary downloads
- **๐ค 24 Optimized MCP Tools** (unified from 45) - Comprehensive task management API for AI assistants
- **๐ณ Unlimited Hierarchy** - Infinite subtask nesting with visual progress tracking
- **๐ Advanced Search** - FTS5 full-text search with fuzzy matching and NLP
- **๐ฏ Smart Dependencies** - Visual dependency management with auto-resolution
- **๐ Bilingual Support** - 668 i18n keys with automatic language detection
- **๐ Data Export/Import** - Multi-step wizards with conflict resolution
- **โก Ultra Performance** - RefreshManager with 90% reduction in operations
## ๐ Zero-Installation Setup
### ๐ฏ NPX Mode (Recommended - No Downloads!)
The easiest way to get started - no binary installation required:
1. **Install Extension**: Search "Gorev" in VS Code marketplace
2. **Auto-Configuration**: Extension uses NPX mode by default
3. **Daemon Auto-Start**: Background daemon automatically starts on first use
4. **Start Working**: Create projects and tasks immediately!
**How it works:**
- Extension detects if Gorev daemon is running (checks `~/.gorev-daemon/.lock`)
- If not running, automatically starts daemon in background
- Daemon serves multiple clients (VS Code + Claude/Cursor/Windsurf simultaneously)
- Web UI automatically available at http://localhost:5082
```json
// Default configuration - no setup needed!
{
"gorev.serverMode": "npx", // Automatic NPX execution
"gorev.autoConnect": true // Connect on startup
}
```
### ๐ง Binary Mode (Advanced Users)
For users who prefer local binary installation:
```json
{
"gorev.serverMode": "binary",
"gorev.serverPath": "/path/to/gorev"
}
```
Follow the [installation guide](https://github.com/msenol/Gorev/blob/main/README.en.md#-installation) for binary setup.
## ๐ฏ Key Features Matrix
| Category | Feature | Description | Status |
|----------|---------|-------------|--------|
| **๐ Setup** | NPX Zero-Install | No downloads, instant setup | โ
|
| **๐ค AI Integration** | 24 Optimized Tools (from 45) | Complete API for AI assistants | โ
|
| **๐ณ Task Management** | Unlimited Hierarchy | Infinite subtask nesting | โ
|
| **๐ Dependencies** | Smart Resolution | Visual dependency management | โ
|
| **๐ Search** | FTS5 Full-Text | SQLite virtual tables, fuzzy matching | โ
|
| **๐ Data Management** | Export/Import Wizards | JSON/CSV with conflict resolution | โ
|
| **๐จ Visual Interface** | Rich TreeView | Progress bars, badges, color coding | โ
|
| **โก Performance** | RefreshManager | 90% operation reduction, debouncing | โ
|
| **๐ Localization** | Bilingual Support | 668 i18n keys, auto-detection | โ
|
| **๐พ Database** | Workspace Mode | Project-specific or global databases | โ
|
| **๐๏ธ Customization** | 50+ Settings | Complete visual and behavioral control | โ
|
| **๐ Real-time** | File Watching | Auto-updates on file changes | โ
|
## ๐ค AI Assistant Integration
### MCP Protocol Compatibility
Works seamlessly with all MCP-compatible AI assistants:
- **โ
Claude Desktop** - Full conversation integration
- **โ
VS Code with MCP** - Native extension support
- **โ
Cursor IDE** - AI coding assistant integration
- **โ
Windsurf** - Development environment integration
- **โ
Any MCP Client** - Universal compatibility
### Natural Language Task Management
Talk to your AI assistant naturally:
```
๐จ๏ธ "Create a new high-priority task for implementing dark mode"
๐จ๏ธ "Show me all overdue tasks with dependencies"
๐จ๏ธ "Mark task #42 as completed and update dependencies"
๐จ๏ธ "Create a bug report template for the login issue"
๐จ๏ธ "Export all completed tasks from last month to CSV"
```
### 24 Optimized MCP Tools (Unified from 45)
| Category | Tools | Description |
|----------|--------|-------------|
| **Task Management** | 6 tools | Create, update, list, detail operations |
| **Subtask Operations** | 3 tools | Hierarchy management and nesting |
| **Project Management** | 6 tools | Project creation, activation, statistics |
| **Template System** | 2 tools | Template-based task creation |
| **Advanced Search** | 6 tools | FTS5 search, suggestions, history |
| **Data Export/Import** | 2 tools | Multi-format data operations |
| **File Watching** | 4 tools | File system monitoring |
| **AI Context** | 6 tools | Context management and NLP |
| **IDE Integration** | 5 tools | Extension management automation |
| **Advanced Operations** | 8 tools | Batch processing, analytics |
## ๐ณ Unlimited Task Hierarchy
### Visual Hierarchy Management
- **๐ Infinite Nesting** - Create tasks within tasks without limits
- **๐ Progress Tracking** - Parent tasks show completion percentage
- **๐ฏ Visual Indicators** - Tree structure with expand/collapse
- **โก Quick Operations** - Drag & drop, inline editing
### Hierarchy Examples
```
๐ Project: E-commerce Platform
โโโ ๐ User Authentication System (75% complete)
โ โโโ โ
JWT Middleware Setup
โ โโโ โ
Login Form Component
โ โโโ ๐ Password Validation
โ โ โโโ โณ Regex Pattern Implementation
โ โ โโโ โณ Error Message Localization
โ โโโ โณ Session Management
โโโ ๐ฑ Mobile Responsive Design (25% complete)
โโโ โ
Breakpoint Analysis
โโโ โณ Component Adaptation
โโโ โณ Header Responsiveness
โโโ โณ Navigation Menu
```
## ๐ Advanced Search & Filtering
### FTS5 Full-Text Search
Powered by SQLite virtual tables for lightning-fast search:
- **๐ Content Search** - Search in titles, descriptions, tags
- **๐ฏ Fuzzy Matching** - Find tasks even with typos
- **๐ง NLP Integration** - Natural language query parsing
- **๐ Search Analytics** - Track search patterns and history
- **๐พ Saved Profiles** - Store complex filter combinations
### Filter Capabilities
```typescript
// Advanced filtering options
{
status: ["pending", "in_progress"],
priority: ["high", "medium"],
tags: ["bug", "urgent"],
dateRange: {
start: "2025-01-01",
end: "2025-12-31"
},
project: "WebApp",
hasDepencies: true,
isOverdue: false
}
```
## ๐ Smart Dependency Management
### Visual Dependency System
- **๐ Blocked Tasks** - Clear visual indicators for blocked tasks
- **๐ Ready Tasks** - Automatic resolution when dependencies complete
- **๐ Linked Tasks** - Bidirectional dependency visualization
- **โก Batch Operations** - Manage multiple dependencies at once
### Dependency Types
| Icon | Status | Description |
|------|--------|-------------|
| ๐ | Blocked | Has incomplete dependencies |
| ๐ | Ready | All dependencies completed |
| ๐ | Linked | Has bidirectional connections |
| โก | Auto | Automatic resolution enabled |
## ๐ Data Export & Import Wizards
### Multi-Step Export Wizard
Advanced export capabilities with guided setup:
1. **๐ Select Format** - JSON (structured) or CSV (tabular)
2. **๐ฏ Choose Scope** - Current view, project, or custom filter
3. **๐
Date Range** - Flexible date filtering options
4. **๐ง Configuration** - Include dependencies, tags, metadata
5. **๐ค Export** - Progress tracking with VS Code notifications
### Import with Conflict Resolution
Intelligent import system with multiple resolution strategies:
- **๐ Skip Conflicts** - Keep existing data unchanged
- **๐ Overwrite** - Replace with imported data
- **๐ Merge** - Smart combination of existing and new data
- **๐ Preview** - See changes before applying
### Export Formats
```json
// JSON Export (structured)
{
"tasks": [...],
"projects": [...],
"dependencies": [...],
"metadata": {
"exportDate": "2025-09-18",
"version": "v0.6.12"
}
}
```
```csv
// CSV Export (tabular)
ID,Title,Status,Priority,Project,Tags,DueDate,Progress
1,"Setup Auth",pending,high,"WebApp","security,auth","2025-10-01",0
```
## โก Performance Optimizations
### RefreshManager Architecture
Revolutionary refresh system with 90% performance improvement:
- **๐ฏ Intelligent Batching** - Group operations for efficiency
- **โฑ๏ธ Priority Debouncing** - High: 100ms, Normal: 500ms, Low: 2s
- **๐ Differential Updates** - Hash-based change detection
- **๐ Performance Monitoring** - Real-time operation tracking
- **๐ซ Zero Blocking** - Non-blocking async operations
### Performance Metrics
| Metric | Before | After | Improvement |
|--------|--------|-------|-------------|
| Refresh Operations | 1000/min | 100/min | 90% reduction |
| UI Thread Blocking | 50ms | 0ms | Zero blocking |
| Memory Usage | 50MB | 35MB | 30% reduction |
| Startup Time | 2s | 1.4s | 30% faster |
## ๐ v0.16.0 API Architecture (NEW!)
### REST API Integration
Complete migration from MCP (stdio + markdown) to REST API (HTTP + JSON):
**Key Benefits:**
- **โก 3x Faster** - Direct HTTP communication vs stdio streams
- **๐ Type-Safe** - Full TypeScript type checking, zero parsing errors
- **๐ก๏ธ Better Errors** - Structured error responses with status codes
- **๐ Web UI Ready** - Shared architecture with embedded web interface
- **๐ Debuggable** - Standard HTTP requests visible in network tools
**Architecture Improvements:**
```typescript
// Before v0.16.0 (MCP + Markdown Parsing)
const result = await mcpClient.callTool('gorev_listele', {});
const tasks = MarkdownParser.parseGorevListesi(result.content[0].text);
// โ Fragile regex parsing, no type safety
// After v0.16.0 (REST API + JSON)
const response = await apiClient.getTasks({});
const tasks = response.data; // Task[] - fully typed!
// โ
Type-safe, no parsing needed
```
**What Changed:**
- โ
All TreeView providers use REST API
- โ
All command handlers use REST API
- โ
Enhanced error handling with ApiError class
- โ
~300 lines of markdown parsing eliminated
- โ ๏ธ MCPClient deprecated (removal in v0.18.0)
- โ ๏ธ MarkdownParser deprecated (removal in v0.18.0)
**Migration Status:** 90% complete
- Remaining: TemplateWizard & TaskDetailPanel (v0.17.0)
## ๐จ Rich Visual Interface
### Enhanced TreeView
Professional-grade tree interface with advanced features:
- **๐ Progress Bars** - Visual completion tracking for parent tasks
- **๐ฏ Priority Badges** - Color-coded priority indicators (๐ฅโกโน๏ธ)
- **๐
Smart Dates** - Relative formatting (Today, Tomorrow, 3d left)
- **๐ Dependency Icons** - Visual dependency status (๐๐๐)
- **๐ท๏ธ Tag Pills** - Colored tag badges with hover details
- **๐ Rich Tooltips** - Markdown tooltips with progress visualization
### Drag & Drop Operations
Intuitive drag & drop for all operations:
- **๐ Move Tasks** - Between projects with visual feedback
- **๐ Change Status** - Drop on status groups to update
- **๐ฏ Reorder Priority** - Drag to change priority levels
- **๐ Create Dependencies** - Drop task on another to create dependency
- **โจ Visual Feedback** - Smooth animations and drop indicators
### Inline Editing
Quick editing without leaving the tree view:
- **โ๏ธ F2 or Double-Click** - Instant title editing
- **๐ Context Menus** - Right-click for status/priority changes
- **๐
Date Picker** - Inline due date selection
- **โจ๏ธ Keyboard Shortcuts** - Escape to cancel, Enter to save
## ๐๏ธ Comprehensive Configuration
### 50+ Configuration Options
Complete control over every aspect of the extension:
#### Server Settings (5 options)
```json
{
"gorev.serverMode": "npx|binary",
"gorev.serverPath": "/path/to/gorev",
"gorev.autoConnect": true,
"gorev.showStatusBar": true,
"gorev.refreshInterval": 300
}
```
#### TreeView Visuals (15 options)
```json
{
"gorev.treeView.grouping": "status|priority|project|tag|dueDate",
"gorev.treeView.sorting": "title|priority|dueDate|created",
"gorev.treeView.sortAscending": false,
"gorev.treeView.showCompleted": true,
"gorev.treeView.showEmptyGroups": false,
"gorev.treeView.visuals.showProgressBars": true,
"gorev.treeView.visuals.showPriorityBadges": true,
"gorev.treeView.visuals.showDueDateIndicators": true,
"gorev.treeView.visuals.showDependencyBadges": true,
"gorev.treeView.visuals.showTagPills": true,
"gorev.treeView.visuals.progressBarStyle": "blocks|percentage|both",
"gorev.treeView.visuals.dueDateFormat": "relative|absolute|smart",
"gorev.treeView.visuals.priorityBadgeStyle": "emoji|text|color",
"gorev.treeView.visuals.tagPillLimit": 3,
"gorev.treeView.visuals.showSubtaskProgress": true
}
```
#### Drag & Drop (8 options)
```json
{
"gorev.dragDrop.allowTaskMove": true,
"gorev.dragDrop.allowStatusChange": true,
"gorev.dragDrop.allowPriorityChange": true,
"gorev.dragDrop.allowProjectMove": true,
"gorev.dragDrop.allowDependencyCreate": true,
"gorev.dragDrop.allowParentChange": true,
"gorev.dragDrop.showDropIndicator": true,
"gorev.dragDrop.enableAnimation": true
}
```
#### Performance (8 options)
```json
{
"gorev.refreshManager.enableBatching": true,
"gorev.refreshManager.batchSize": 10,
"gorev.refreshManager.highPriorityDelay": 100,
"gorev.refreshManager.normalPriorityDelay": 500,
"gorev.refreshManager.lowPriorityDelay": 2000,
"gorev.performance.enableMonitoring": true,
"gorev.performance.slowOperationThreshold": 1000,
"gorev.performance.maxMetrics": 1000
}
```
#### Database Modes (3 options)
```json
{
"gorev.databaseMode": "auto|workspace|global",
"gorev.workspaceDatabase.autoDetect": true,
"gorev.workspaceDatabase.showModeInStatusBar": true
}
```
## ๐ Internationalization
### Complete Bilingual Support
- **668 i18n Keys** - Every UI element translated
- **Auto-Detection** - Follows VS Code language setting
- **Languages**: English (en) and Turkish (tr)
- **Context-Aware** - Smart translations based on usage
### Translation Examples
| English | Turkish | Context |
|---------|---------|---------|
| "Create Task" | "Gรถrev Oluลtur" | Command |
| "High Priority" | "Yรผksek รncelik" | Priority badge |
| "Dependencies blocked" | "Baฤฤฑmlฤฑlฤฑklar engelledi" | Status |
| "Export completed" | "Dฤฑลa aktarma tamamlandฤฑ" | Notification |
## ๐พ Database Management
### Flexible Database Modes
#### Workspace Mode (Default)
- **๐ Project-Specific** - Each project has its own `.gorev/gorev.db`
- **๐ Auto-Detection** - Automatically finds workspace databases
- **๐ Status Indicator** - Shows current database in status bar
#### Global Mode
- **๐ Shared Database** - Single database for all projects
- **๐ User Directory** - Stored in `~/.gorev/gorev.db`
- **๐ Easy Switching** - Toggle between modes via command
#### Auto Mode
- **๐ค Intelligent Selection** - Automatically chooses best database
- **โฌ๏ธ Fallback Chain** - Workspace โ Parent โ Global
- **โก Zero Configuration** - Works out of the box
## ๐ 50+ Available Commands
### Task Operations (15 commands)
- `gorev.createTask` - Create new task
- `gorev.updateTaskStatus` - Update task status
- `gorev.showTaskDetail` - Show detailed task view
- `gorev.deleteTask` - Delete task
- `gorev.markAsCompleted` - Quick completion
- `gorev.setTaskPriority` - Change priority
- `gorev.addTaskTag` - Add tags
- `gorev.setTaskDueDate` - Set due date
- `gorev.createSubtask` - Add subtask
- `gorev.moveTo` - Move to project
- `gorev.duplicateTask` - Clone task
- `gorev.addTaskNote` - Add notes
- `gorev.linkTasks` - Create dependency
- `gorev.unlinkTasks` - Remove dependency
- `gorev.showTaskHistory` - View history
### Project Management (8 commands)
- `gorev.createProject` - Create new project
- `gorev.setActiveProject` - Set active project
- `gorev.showProjectStats` - View statistics
- `gorev.deleteProject` - Delete project
- `gorev.renameProject` - Rename project
- `gorev.archiveProject` - Archive project
- `gorev.exportProject` - Export project data
- `gorev.duplicateProject` - Clone project
### Template System (7 commands)
- `gorev.openTemplateWizard` - Template wizard
- `gorev.createFromTemplate` - Create from template
- `gorev.quickCreateFromTemplate` - Quick template selection
- `gorev.refreshTemplates` - Reload templates
- `gorev.initDefaultTemplates` - Initialize defaults
- `gorev.showTemplateDetails` - Template details
- `gorev.exportTemplate` - Export template
### Data Operations (4 commands)
- `gorev.exportData` - Export data wizard
- `gorev.importData` - Import data wizard
- `gorev.exportCurrentView` - Export current view
- `gorev.quickExport` - Quick export
### Filter Operations (10 commands)
- `gorev.showSearchInput` - Search tasks
- `gorev.showFilterMenu` - Filter menu
- `gorev.showFilterProfiles` - Saved profiles
- `gorev.clearAllFilters` - Clear filters
- `gorev.filterOverdue` - Show overdue
- `gorev.filterDueToday` - Show due today
- `gorev.filterDueThisWeek` - Show due this week
- `gorev.filterHighPriority` - Show high priority
- `gorev.filterActiveProject` - Show active project
- `gorev.filterByTag` - Filter by tag
### Debug Tools (6 commands)
- `gorev.showDebugInfo` - Debug information
- `gorev.clearDebugLogs` - Clear logs
- `gorev.testConnection` - Test MCP connection
- `gorev.refreshAllViews` - Force refresh
- `gorev.resetExtension` - Reset state
- `gorev.generateTestData` - Generate test data
## ๐ File System Integration
### File Watcher Capabilities
- **๐ Project Monitoring** - Watch project files for changes
- **๐ Auto-Updates** - Automatic task status transitions
- **โก Real-Time Sync** - Instant UI updates on file changes
- **๐ฏ Selective Watching** - Configure which files to monitor
### Integration Patterns
```javascript
// Automatic status updates based on file changes
.gitignore change โ Update "Setup Git" task
package.json change โ Update "Configure Dependencies" task
README.md change โ Update "Documentation" task
```
## ๐ Advanced Capabilities
### Professional Template Wizard ๐ฏ NEW
**Complete redesign with professional UI/UX for enhanced task creation:**
- **๐จ 9 Field Types** - Text, textarea, select, date, tags, email, URL, number, markdown
- **โก Real-Time Validation** - Dynamic field validation with visual feedback
- **๐ Markdown Preview** - Live markdown rendering with local marked.js bundle
- **๐ซ Professional Styling** - 300+ lines of enhanced CSS with animations
- **โญ Favorites System** - Save and manage favorite templates with localStorage
- **๐ Form States** - Loading states, error handling, and validation feedback
- **๐ก๏ธ Security Enhanced** - Local asset bundling, no CDN dependencies
### Template System with Aliases
Pre-built templates for common task types:
- **๐ Bug Report** (`bug`) - Structured bug documentation with required fields
- **โจ Feature Request** (`feature`) - New feature specifications with validation
- **๐ฌ Research** (`research`) - Investigation and learning tasks with time tracking
- **โก Spike** (`spike`) - Time-boxed exploration with scope definition
- **๐ Security** (`security`) - Security-related tasks with impact assessment
- **๐ Performance** (`performance`) - Optimization tasks with metrics tracking
- **๐ง Refactoring** (`refactor`) - Code improvement tasks with before/after
- **๐ณ Technical Debt** (`debt`) - Code debt tracking with priority scoring
### Batch Operations
Efficient bulk operations for productivity:
- **โ
Multi-Select** - Ctrl/Cmd+Click for multiple selection
- **๐ Batch Status Update** - Change status for multiple tasks
- **๐๏ธ Bulk Delete** - Delete multiple tasks at once
- **๐ท๏ธ Tag Management** - Add/remove tags in bulk
- **๐ Project Migration** - Move multiple tasks between projects
### Analytics & Reporting
Built-in analytics for project insights:
- **๐ Progress Tracking** - Visual progress charts
- **โฑ๏ธ Time Analysis** - Task completion patterns
- **๐ฏ Priority Distribution** - Priority level analysis
- **๐
Due Date Insights** - Deadline compliance tracking
- **๐ฅ Dependency Analysis** - Dependency complexity metrics
## ๐ฎ Usage Examples
### Getting Started Workflow
```
1. ๐ฆ Install Extension โ Search "Gorev" in VS Code marketplace
2. ๐ Auto-Setup โ Extension automatically configures NPX mode
3. ๐ Create Project โ "Web Application Development"
4. ๐ฏ Add Tasks โ Use template wizard for structured tasks
5. ๐ณ Build Hierarchy โ Create subtasks with unlimited nesting
6. ๐ Set Dependencies โ Link related tasks for workflow
7. ๐ Track Progress โ Watch visual progress indicators
8. ๐ Use Search โ Find tasks quickly with FTS5 search
9. ๐ค Export Data โ Share progress with team via CSV/JSON
```
### AI Assistant Workflow
```
๐ค "Hey Claude, I need help organizing my project tasks"
๐จ๏ธ "Create a bug report task for the login form validation issue"
โ Creates structured bug report with severity, steps, environment
๐จ๏ธ "Show me all high-priority tasks that are overdue"
โ Filters and displays urgent tasks needing attention
๐จ๏ธ "Mark the JWT middleware task as completed"
โ Updates status and auto-resolves dependent tasks
๐จ๏ธ "Export all completed tasks from this sprint to CSV"
โ Generates report for sprint review meeting
```
### Advanced Search Examples
```
๐ "authentication bug high" โ Fuzzy search across titles/descriptions
๐ "status:pending priority:high" โ Structured filter query
๐ "project:WebApp overdue" โ Project-specific overdue tasks
๐ "tags:security,urgent" โ Multi-tag intersection search
๐ "created:last-week" โ Date-relative search
```
## ๐ ๏ธ Installation Methods
### Method 1: VS Code Marketplace (Recommended)
```
1. Open VS Code
2. Go to Extensions (Ctrl+Shift+X)
3. Search for "Gorev"
4. Click Install
5. Start using immediately!
```
### Method 2: Command Line
```bash
code --install-extension mehmetsenol.gorev-vscode
```
### Method 3: VSIX File
Download from [GitHub Releases](https://github.com/msenol/Gorev/releases) and install manually.
## ๐ง Troubleshooting
### Common Issues
**NPX Mode Not Working?**
```bash
# Check Node.js version (requires 14+)
node --version
# Test NPX directly
npx @mehmetsenol/gorev-mcp-server@latest --version
```
**Binary Mode Connection Issues?**
```bash
# Verify binary installation
gorev version
# Check binary path in settings
"gorev.serverPath": "/usr/local/bin/gorev"
```
**Extension Not Loading?**
1. Check VS Code Output โ Gorev channel
2. Restart VS Code
3. Check for conflicting extensions
4. Reset extension settings
### Debug Mode
Enable debug logging for troubleshooting:
```json
{
"gorev.debug.enabled": true,
"gorev.debug.logLevel": "debug",
"gorev.debug.showInOutput": true
}
```
## ๐ Performance & Statistics
### Extension Metrics
- **๐ Test Coverage**: 100% (VS Code extension)
- **๐ฏ MCP Tools**: 24 optimized tools (unified from 45)
- **๐ Languages**: English + Turkish support
- **๐ป Platforms**: Windows, macOS, Linux
- **โก Performance**: 90% operation reduction
- **๐ง Configuration**: 50+ customizable settings
- **๐ฑ Commands**: 50+ available commands
- **๐จ Visual**: 15+ customization options
### Architecture Highlights
- **๐๏ธ TypeScript**: Strict mode with full type safety
- **๐ Thread Safety**: Race-condition free operations
- **โก Async Operations**: Non-blocking UI interactions
- **๐ Memory Efficient**: Smart caching and cleanup
- **๐ Reactive Updates**: Event-driven architecture
- **๐ฏ Modular Design**: Clean separation of concerns
## ๐ค Integration Points
### MCP Clients Compatibility
| Client | Status | Features |
|--------|--------|----------|
| **Claude Desktop** | โ
Full | All 24 optimized MCP tools, conversation integration |
| **VS Code MCP** | โ
Full | Native extension, direct integration |
| **Cursor IDE** | โ
Full | AI coding assistant, context awareness |
| **Windsurf** | โ
Full | Development environment integration |
| **Zed Editor** | ๐ Planned | Future MCP support integration |
### Development Tools
- **Git Integration** - Track file changes and task updates
- **Project Templates** - Scaffold new projects with task templates
- **CI/CD Hooks** - Integrate with build and deployment pipelines
- **Documentation** - Auto-generate documentation from task structure
## ๐ Resources & Support
### Documentation
- ๐ [Main Repository](https://github.com/msenol/Gorev) - Complete source code and docs
- ๐ง [MCP Tools Reference](https://github.com/msenol/Gorev/blob/main/docs/api/MCP_TOOLS_REFERENCE.md) - All 24 optimized tools documented
- ๐ [Installation Guide](https://github.com/msenol/Gorev/blob/main/README.en.md#-installation) - Binary setup instructions
- ๐ฏ [VS Code Extension Guide](https://github.com/msenol/Gorev/blob/main/docs/user-guide/vscode-extension.md) - Advanced usage
### Community & Support
- ๐ [Issue Tracker](https://github.com/msenol/Gorev/issues) - Bug reports and feature requests
- ๐ฌ [Discussions](https://github.com/msenol/Gorev/discussions) - Community discussions
- โ [FAQ](https://github.com/msenol/Gorev/wiki/FAQ) - Frequently asked questions
- ๐ง [Contact](mailto:me@mehmetsenol.dev) - Direct developer contact
### Contribution
1. ๐ด Fork the repository
2. ๐ฟ Create a feature branch
3. โจ Make your changes
4. ๐งช Add tests if applicable
5. ๐ Submit a pull request
## ๐ License
This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.
## ๐ Acknowledgments
- **MCP Protocol** - For enabling seamless AI integration
- **SQLite FTS5** - For powerful full-text search capabilities
- **VS Code API** - For extensible editor integration
- **Community** - For feedback, bug reports, and feature requests
---
<div align="center">
**Made with โค๏ธ for productive developers**
[โฌ Back to Top](#gorev---advanced-task-management--ai-integration-for-vs-code)
**Try it now:** [Install from VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=mehmetsenol.gorev-vscode)
</div>
