🚀 Gorev

🎯 What is Gorev

Gorev is a powerful Model Context Protocol (MCP) server written in Go that provides task management capabilities to all MCP-compatible AI editors (Claude Desktop, VS Code, Windsurf, Cursor, Zed, etc.). It combines project management, task tracking, and organization needs with the power of AI assistants to boost your productivity.

🏗️ Three-Module Architecture

1. gorev-mcpserver - MCP server written in Go (core component)
   • Embedded Web UI 🌐 - React interface embedded in binary (NEW! v0.16.0)
   • REST API server (Fiber framework)
   • MCP protocol support
2. gorev-vscode - VS Code extension (optional visual interface)
3. gorev-web - React + TypeScript source code (development)

Thanks to the MCP protocol, you can connect to the server from any MCP-compatible editor. The daemon automatically starts on first MCP connection, and the Web UI becomes available at http://localhost:5082. The VS Code extension provides a rich IDE-integrated experience with automatic daemon management.

🔌 Daemon Architecture (v0.16.0+)

Gorev runs as a background daemon process, providing these key benefits:

Core Features:

• Single Instance Management: Lock file (~/.gorev-daemon/.lock) prevents port conflicts
• Multi-Client Support: Multiple MCP clients (Claude, VS Code, Windsurf, Cursor) can connect simultaneously
• Auto-Start: VS Code extension automatically detects and starts daemon (v0.16.2+)
• Health Monitoring: Real-time status via /api/health endpoint
• WebSocket Support: Real-time task update events (experimental)

Quick Start:

# Start daemon in background
gorev daemon --detach

# Check daemon status
curl http://localhost:5082/api/health

# Web UI automatically available
open http://localhost:5082

Architecture Diagram

graph TB
    subgraph "External Clients"
        Claude[Claude Desktop/Code]
        VSCode[VS Code Extension]
        Cursor[Cursor IDE]
        Windsurf[Windsurf]
    end

    subgraph "Gorev Daemon (Port 5082)"
        Lock[Lock File<br/>~/.gorev-daemon/.lock]

        subgraph "Protocol Layers"
            MCP[MCP Proxy<br/>stdio]
            REST[REST API<br/>Fiber - 23 endpoints]
            WS[WebSocket<br/>Real-time events]
        end

        Handler[MCP Handlers<br/>24 Unified Tools]

        subgraph "Storage"
            DB[(SQLite DB<br/>.gorev/gorev.db)]
        end

        WebUI[Embedded Web UI<br/>React + TypeScript]
    end

    Claude -->|MCP/stdio| MCP
    VSCode -->|REST/HTTP| REST
    Cursor -->|MCP/stdio| MCP
    Windsurf -->|MCP/stdio| MCP

    MCP --> Handler
    REST --> Handler
    WS -.->|broadcasts| VSCode

    Handler --> DB

    REST --> WebUI

    Lock -.->|man

... [View full README on GitHub](https://github.com/msenol/Gorev#readme)