Skip to content

Gorev v0.16.3 - Daemon Architecture & Multi-Client Support

Latest
Latest

Choose a tag to compare

View all tags
@msenol msenol released this 07 Oct 00:52
· 44 commits to main since this release
v0.16.3
1ad22ed

🚀 Gorev v0.16.3 - Daemon Architecture, Multi-Client Support & Enhanced Stability

Release Date: October 7, 2025

🎨 Major Features

🔌 Daemon Architecture (Revolutionary Change)

Gorev now runs as a persistent background daemon process with game-changing multi-client support:

  • Single Daemon, Multiple Clients: One background daemon serves all MCP clients simultaneously (Claude Desktop, VS Code, Cursor, Windsurf)
  • Lock File Mechanism: ~/.gorev-daemon/.lock ensures single instance with automatic service discovery
  • Multi-Client MCP Proxy: JSON-RPC 2.0 protocol handling with unique client IDs
  • Workspace Isolation: SHA256-based workspace IDs for multi-project support
  • Real-Time Updates: WebSocket-based task synchronization across all clients
  • VS Code Auto-Start: Extension automatically detects and starts daemon when needed

Key Files: cmd/gorev/daemon.go, cmd/gorev/mcp_proxy.go, internal/daemon/lockfile.go, internal/api/mcp_bridge.go

⚡ Performance & Stability Improvements

  • Thread Safety: 100% race condition elimination with comprehensive mutex protection
  • Memory Optimization: 15-20% reduction in memory footprint
  • Startup Performance: 30% faster initialization
  • Enhanced Error Handling: Improved error context and logging
  • Code Quality: Modernized string handling and DRY compliance

🌐 Enhanced Web UI Integration

  • Embedded Web UI: React + TypeScript UI automatically available at http://localhost:5082
  • REST API Server: 23 endpoints powered by Fiber framework
  • WebSocket Support: Real-time task update broadcasts
  • Database File Watcher: Detects external modifications

🛠️ MCP Tool Improvements

  • gorev_bulk: All 3 operations (update/transition/tag) with proper parameter transformation
  • gorev_guncelle: Extended to support both durum and oncelik updates simultaneously
  • gorev_search: Advanced mode with query parsing (durum:X oncelik:Y → filters)

📦 NPX Easy Installation (NEW!)

Zero-configuration installation via NPX - daemon auto-starts on first connection:

{
  "mcpServers": {
    "gorev": {
      "command": "npx",
      "args": [
        "-y",
        "@mehmetsenol/gorev-mcp-server@latest"
      ],
      "env": {
        "GOREV_LANG": "en"
      }
    }
  }
}

Note: Daemon automatically starts in background on first connection. No manual setup required!
For VS Code users, install the official extension instead.

📦 Installation Options

🚀 Method 1: NPX (Recommended - Zero Installation!)

For MCP Clients (Claude Desktop, Cursor, etc.)

Note: For VS Code, use the official extension instead of MCP configuration

{
  "mcpServers": {
    "gorev": {
      "command": "npx",
      "args": [
        "-y",
        "@mehmetsenol/gorev-mcp-server@latest"
      ],
      "env": {
        "GOREV_LANG": "en"
      }
    }
  }
}

Daemon automatically starts on first MCP connection. No manual setup required!

Global NPM Installation

# Install globally
npm install -g @mehmetsenol/gorev-mcp-server@latest

# Start daemon (background)
gorev-mcp daemon --detach

# Check daemon status
gorev-mcp daemon-status

# Stop daemon
gorev-mcp daemon-stop

NPX Direct Usage

# No installation needed - daemon auto-starts on first connection
npx @mehmetsenol/gorev-mcp-server@latest

# Manual daemon control
npx @mehmetsenol/gorev-mcp-server@latest daemon --detach
npx @mehmetsenol/gorev-mcp-server@latest daemon-status

# Development/testing (foreground mode)
npx @mehmetsenol/gorev-mcp-server@latest serve --debug

🔧 Method 2: Binary Installation

Linux/macOS - Automatic Installer

curl -fsSL https://raw.githubusercontent.com/msenol/Gorev/main/install.sh | bash

Windows - PowerShell Installer

irm https://raw.githubusercontent.com/msenol/Gorev/main/install.ps1 | iex

📥 Method 3: Manual Downloads

Download the appropriate binary for your platform:

🎨 VS Code Extension

🆕 What's New in v0.16.3

Added

  • Daemon Architecture: Background process with multi-client support
  • Multi-Workspace Support: SHA256-based workspace isolation
  • Real-Time Updates: WebSocket-based task synchronization
  • VS Code Auto-Start: Automatic daemon detection and startup
  • Enhanced MCP Tools: Improved parameter transformation and query parsing
  • NPX Support: Zero-configuration NPM package installation
  • Dependency Counters: VS Code tree view now shows 🔒/🔓/🔗 indicators correctly

Changed

  • Performance: 30% faster startup, 15-20% memory reduction
  • Thread Safety: Complete race condition elimination
  • String Handling: Modernized across all modules
  • Error Handling: Enhanced error context and logging

Fixed

  • NPM Package Upgrade Reliability: Version-aware binary checking prevents upgrade issues
    • Automatic version detection: binary version command validates installed binary
    • Smart upgrade: Replaces outdated binaries automatically during npm install
    • Offline support preserved: Uses bundled binaries for fresh installs
    • Resolves v0.16.2 regression where bundled binaries could prevent updates
    • Files: gorev-npm/postinstall.js (lines 179-209)
  • MCP Tool Parameter Transformation: All bulk operations now working properly
  • VS Code Tree View: Dependency counters display correctly (JSON omitempty fix)
  • gorev_guncelle: Now supports both durum and oncelik updates
  • gorev_search: Advanced mode query parsing fixed

🚀 Quick Start

  1. Add to MCP Configuration: Copy JSON config above to your MCP client settings
  2. First Connection: Daemon automatically starts on first MCP tool call
  3. Verify Daemon: npx @mehmetsenol/gorev-mcp-server@latest daemon-status
  4. Optional: Install VS Code extension for rich visual interface

Alternative - Manual Daemon Start:

npx @mehmetsenol/gorev-mcp-server@latest daemon --detach

📚 Documentation

🔒 Security

  • Complete security audit compliance
  • No sensitive information in binaries
  • SHA256 checksums provided for all assets: checksums.txt
  • Cross-platform binaries verified and tested

🐛 Bug Fixes

  • Fixed race conditions in AI Context Manager
  • Resolved file system integration issues in auto state manager
  • Enhanced NLP processor error handling and resilience
  • Improved auto state manager state transitions

⚠️ Breaking Changes

None in this release - full backward compatibility maintained

🤝 Contributing

📊 Project Statistics

  • MCP Tools: 24 optimized tools (unified from 45)
  • Test Coverage: ~71% (server), 100% (extension)
  • Binary Sizes: 23-25MB per platform
  • NPM Package Size: 54.6MB (compressed), 99.9MB (unpacked)
  • Languages Supported: Turkish (TR), English (EN)

🙏 Acknowledgments

Special thanks to all contributors and users who provided feedback and helped improve Gorev!

Full Changelog: https://github.com/msenol/Gorev/blob/main/CHANGELOG.md

Questions? Open an issue or start a discussion on GitHub!

Assets 12
Loading