Gorev

This project is currently underactive development. Breaking changes, API modifications, and feature updates may occur frequently. Use with caution in production environments.

Last Updated:November 28, 2025 |Version:v0.17.0

🎉NEW in v0.17.0: MCP tool parameter transformation fixes + 100% test successFeatures•Installation•Usage•Documentation•Contributing

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

# Start daemon in background gorev daemon --detach # Check daemon status curl http://localhost:5082/api/health # Web UI automatically available open http://localhost:5082

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 -.->|manages| MCP Lock -.->|manages| REST style Claude fill:#f9f,stroke:#333 style VSCode fill:#9cf,stroke:#333 style Cursor fill:#fc9,stroke:#333 style Windsurf fill:#9fc,stroke:#333 style Handler fill:#ff9,stroke:#333 style DB fill:#9f9,stroke:#333

- Lock File:~/.gorev-daemon/.lockcontains PID, port, version, and daemon URL
- REST API Server: 23 endpoints for VS Code extension (Fiber framework)
- MCP Proxy: Forwards stdio MCP protocol requests to internal handlers
- WebSocket Server: Real-time event broadcasting for task updates
- Workspace Manager: Multi-workspace support with SHA256-based IDs

VS Code Integration:The extension automatically manages the daemon lifecycle:
- On activation, checks if daemon is running (reads lock file)
- Starts daemon if not running
- Connects to REST API for all operations
- Optionally shuts down daemon on deactivation (if extension started it)

SeeDaemon Architecture Documentationfor detailed technical specifications.

- updateoperation: Properly transforms{ids: [], data: {}}→{updates: [{id, ...fields}]}
- transitionoperation: Accepts bothstatusandyeni_durumparameter names for flexibility
- tagoperation: Accepts bothoperationandtag_operationparameter names
- Test result: 100% success rate (5/5 operations passed in production)

gorev_guncelle- Extended to support multiple field updates:

- Can updatestatus(status),priority(priority), or both simultaneously
- At least one parameter required for validation
- Backward compatible with existing code

gorev_search (advanced mode)- Smart query parsing added:

- Example:"durum:devam_ediyor oncelik:yuksek tags:frontend"
- Automatically extracts filters from natural language queries
- Multi-filter support with space-separated key:value pairs
- Works seamlessly with existing filter parameters

VS Code Tree View- Dependency indicators now visible:

- 🔒 (blocked), 🔓 (unblocked), 🔗 (dependents) icons display correctly
- Fixed JSON serialization issue (removedomitemptyfrom dependency counters)
- All dependency relationships now visible in tree structure

Validation: 100% success rate confirmed by Kilocode AI comprehensive test report

🐛 Previous Updates (v0.16.2 - October 5, 2025)

- NPM Binary Update Fix: Fixed critical bug where NPM package upgrades preserved old binaries

- Users upgrading from v0.16.1 or earlier were stuck on v0.15.24 (September 2025)
- Package size reduced from 78.4 MB to 6.9 KB (binaries now always downloaded from GitHub)
- All users now get latest features (REST API, Web UI, VS Code auto-start)

- No manual commands required - daemon auto-starts via lock file detection
- Checks if daemon is running (~/.gorev-daemon/.lock), starts if needed
- Proper database path configuration (workspace/.gorev/gorev.db)
- Shared daemon across all MCP clients (Claude, Cursor, Windsurf)

- Zero-Configuration: Modern React interface built into Go binary
- Instant Access: Automatically available athttp://localhost:5082
- Full Features: Tasks, projects, templates, subtasks, and dependencies
- Language Sync: Turkish/English switcher synchronized with MCP server
- No Separate Installation: Just runnpx @mehmetsenol/gorev-mcp-server serveand you're ready!

- Quick Commands: Usebug,feature,researchinstead of template IDs
- Consistency: Same aliases across all workspaces
- No More UUID Hunting: Human-readable template identifiers
- Documentation: Full guide at[MCP Config Examples

- Package Name:@mehmetsenol/gorev-mcp-server
- Global Install:npm install -g @mehmetsenol/gorev-mcp-server
- NPX Ready:npx @mehmetsenol/gorev-mcp-server servefor instant use
- Cross-Platform: Works on Windows, macOS, and Linux

- Smart task creation- Using natural language commands
- Markdown support- Rich description formatting
- Status management- Pending → In Progress → Completed
- Priority levels- Low, Medium, High
- Flexible editing- Update all task properties

…