{"id":29182522,"url":"https://github.com/msenol/gorev","last_synced_at":"2026-05-05T04:10:47.999Z","repository":{"id":301791038,"uuid":"1010315014","full_name":"msenol/Gorev","owner":"msenol","description":"Modern task management system with Turkish support for MCP-compatible AI assistants (Claude, VS Code, Windsurf, Cursor). Features unlimited subtask hierarchy, dependencies, templates, and 84.6% test coverage.","archived":false,"fork":false,"pushed_at":"2025-09-12T23:01:27.000Z","size":26965,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-13T00:25:13.929Z","etag":null,"topics":["ai-assistant","ai-tools","cli","dependencies","go","markdown","mcp","productivity","project-management","sqlite","subtasks","task-management","turkish","vscode-extension"],"latest_commit_sha":null,"homepage":"https://marketplace.visualstudio.com/items?itemName=mehmetsenol.gorev-vscode","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/msenol.png","metadata":{"files":{"readme":"README.en.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"docs/security/thread-safety.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-06-28T20:06:20.000Z","updated_at":"2025-09-12T23:01:30.000Z","dependencies_parsed_at":"2025-09-13T00:21:55.500Z","dependency_job_id":null,"html_url":"https://github.com/msenol/Gorev","commit_stats":null,"previous_names":["msenol/gorev"],"tags_count":18,"template":false,"template_full_name":null,"purl":"pkg:github/msenol/Gorev","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msenol%2FGorev","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msenol%2FGorev/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msenol%2FGorev/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msenol%2FGorev/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/msenol","download_url":"https://codeload.github.com/msenol/Gorev/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msenol%2FGorev/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":275894378,"owners_count":25547859,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-19T02:00:09.700Z","response_time":108,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-assistant","ai-tools","cli","dependencies","go","markdown","mcp","productivity","project-management","sqlite","subtasks","task-management","turkish","vscode-extension"],"created_at":"2025-07-01T20:06:37.240Z","updated_at":"2025-09-19T06:52:15.120Z","avatar_url":"https://github.com/msenol.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 Gorev\n\n\u003cdiv align=\"center\"\u003e\n\n**Last Updated:** September 18, 2025 | **Version:** v0.15.5\n\n[🇺🇸 English](README.en.md) | [🇹🇷 Türkçe](README.md)\n\n\u003e ⚠️ **BREAKING CHANGE (v0.10.0)**: The `gorev_olustur` tool is no longer available! Template usage is now mandatory. [Details](#breaking-change-template-requirement)\n\n![Go Version](https://img.shields.io/badge/Go-1.23+-00ADD8?style=flat-square\u0026logo=go)\n![MCP](https://img.shields.io/badge/MCP-Compatible-4A154B?style=flat-square\u0026logo=anthropic)\n![License](https://img.shields.io/badge/License-MIT-green?style=flat-square)\n![Test Coverage](https://img.shields.io/badge/Coverage-84.6%25-brightgreen?style=flat-square)\n![Platform](https://img.shields.io/badge/Platform-Linux%20|%20macOS%20|%20Windows-blue?style=flat-square)\n\n**Modern task management system with Turkish support, designed for MCP-compatible AI assistants (Claude, VS Code, Windsurf, Cursor)**\n\n[Features](#-features) • [Installation](#-installation) • [Usage](#-usage) • [Documentation](#-documentation) • [Contributing](#-contributing)\n\n\u003c/div\u003e\n\n## 🎯 What is Gorev?\n\nGorev 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.\n\n### 🏗️ Two-Module Architecture\n\n1. **gorev-mcpserver** - MCP server written in Go (core component)\n2. **gorev-vscode** - VS Code extension (optional visual interface)\n\nThanks to the MCP protocol, you can connect to the server from any MCP-compatible editor. The VS Code extension provides a rich visual experience.\n\n## ✨ Features\n\n### 📝 Task Management\n- **Smart task creation** - Using natural language commands\n- **Markdown support** - Rich description formatting\n- **Status management** - Pending → In Progress → Completed\n- **Priority levels** - Low, Medium, High\n- **Flexible editing** - Update all task properties\n\n### 📁 Project Organization\n- **Hierarchical structure** - Task grouping under projects\n- **Active project system** - Quick operations with default project\n- **Project-based reporting** - Detailed statistics\n- **Multi-project support** - Unlimited project creation\n\n### 🔗 Advanced Features\n- **📅 Due date tracking** - Deadline management and urgent task filtering\n- **🏷️ Tagging system** - Multi-tag categorization\n- **🔄 Task dependencies** - Inter-task automation\n- **📋 Ready-made templates** - Bug reports, feature requests, and more\n- **🔍 Advanced filtering** - Status, tag, date-based queries\n- **🌳 Subtask hierarchy** - Unlimited depth task tree structure\n- **📊 Progress tracking** - Subtask completion percentage in parent tasks\n- **📁 File System Watcher** - Monitor file changes and automatic task status transitions\n- **🔔 Automatic Status Updates** - \"pending\" → \"in_progress\" automation on file changes\n- **⚙️ Configuration Management** - Customizable ignore patterns and watch rules\n\n### 🤖 AI Integration\n- **Natural language processing** - Task management by talking to AI assistants\n- **Multi-editor support** - Claude, VS Code, Windsurf, Cursor, Zed\n- **Contextual understanding** - Smart command interpretation\n- **MCP standard** - Compatible with all MCP-compatible tools\n\n### 🎨 VS Code Extension Features (Optional)\n- **Bilingual Support** - Turkish and English interface (v0.5.0+) 🌍\n- **TreeView Panels** - Task, project, and template lists\n- **Visual Interface** - Click-and-use experience\n- **Status Bar** - Real-time status information\n- **Command Palette** - Quick access (Ctrl+Shift+G)\n- **Color Coding** - Priority-based visual distinction\n- **Context Menus** - Right-click operations\n- **Automatic Language Detection** - UI language based on VS Code language setting\n- **[Download from Marketplace](https://marketplace.visualstudio.com/items?itemName=mehmetsenol.gorev-vscode)** 🚀\n\n## 📦 Installation\n\n### 🚀 NPX Easy Setup (Easiest!)\n\nFor MCP clients, simply add to your `mcp.json` configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"gorev\": {\n      \"command\": \"npx\",\n      \"args\": [\"@mehmetsenol/gorev-mcp-server@latest\"],\n      \"env\": {\n        \"GOREV_LANG\": \"en\"\n      }\n    }\n  }\n}\n```\n\n**For Claude Desktop:**\n```json\n// Windows: %APPDATA%/Claude/claude_desktop_config.json\n// macOS: ~/Library/Application Support/Claude/claude_desktop_config.json\n// Linux: ~/.config/Claude/claude_desktop_config.json\n{\n  \"mcpServers\": {\n    \"gorev\": {\n      \"command\": \"npx\",\n      \"args\": [\"@mehmetsenol/gorev-mcp-server@latest\"],\n      \"env\": {\n        \"GOREV_LANG\": \"en\"\n      }\n    }\n  }\n}\n```\n\n**For VS Code:**\n```json\n// .vscode/mcp.json\n{\n  \"servers\": {\n    \"gorev\": {\n      \"command\": \"npx\",\n      \"args\": [\"@mehmetsenol/gorev-mcp-server@latest\"]\n    }\n  }\n}\n```\n\n**For Cursor:**\n```json\n{\n  \"mcpServers\": {\n    \"gorev\": {\n      \"command\": \"npx\",\n      \"args\": [\"@mehmetsenol/gorev-mcp-server@latest\"]\n    }\n  }\n}\n```\n\n### 🔧 Traditional Installation (Automatic)\n\n```bash\n# Linux/macOS\ncurl -fsSL https://raw.githubusercontent.com/msenol/Gorev/main/install.sh | bash\n\n# Specific version\ncurl -fsSL https://raw.githubusercontent.com/msenol/Gorev/main/install.sh | VERSION=v0.11.0 bash\n```\n\n### 🪟 Windows\n\n```powershell\n# PowerShell (no admin rights required)\nirm https://raw.githubusercontent.com/msenol/Gorev/main/install.ps1 | iex\n\n# Or for specific version:\n$env:VERSION=\"v0.11.0\"; irm https://raw.githubusercontent.com/msenol/Gorev/main/install.ps1 | iex\n```\n\n### 💻 VS Code Extension (Optional)\n\n**Option 1: Gorev VS Code Extension (Recommended)**\n\nInstall from [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=mehmetsenol.gorev-vscode)\n\n```bash\ncode --install-extension mehmetsenol.gorev-vscode\n```\n\n## 🎮 Usage\n\n### AI Assistant Example Commands\n\n```\n\"Create a new task: Write API documentation\"\n\"List urgent tasks\"\n\"Show tasks tagged with bug\"\n\"Set Mobile App v2 project as active\"\n\"Create new project for sprint planning\"\n\"Mark task #5 as completed\"\n\"Create new task from feature request template\"\n\"Start watching project files\"\n\"Enable automatic status transitions on file changes\"\n\"Show watch list\"\n\"Add git ignore rules to file watcher\"\n```\n\n\u003e 💡 **Tip**: These commands work with Claude, VS Code Copilot, Windsurf AI, Cursor, and other MCP-compatible AI assistants.\n\n### CLI Commands\n\n```bash\n# Start server\ngorev serve                  # Normal mode\ngorev serve --debug         # Debug mode\ngorev serve --port 8080     # Different port\n\n# Task operations\ngorev task list             # List tasks\ngorev task create           # Create new task\ngorev task show \u003cid\u003e        # Task details\n\n# Project operations\ngorev project list          # List projects\ngorev project create        # Create new project\n\n# Other\ngorev version              # Version info\ngorev help                 # Help\n```\n\n## 📚 Documentation\n\nFor detailed documentation, see the [docs/](docs/) folder:\n\n- 📦 [Installation Guide](docs/guides/getting-started/installation.md) - Platform-specific installation instructions\n- 📖 [Usage Guide](docs/guides/user/usage.md) - Detailed usage examples\n- 🛠 [MCP Tools](docs/guides/user/mcp-tools.md) - Complete reference for 48 MCP tools\n- 🤖 [AI MCP Tools](docs/tr/mcp-araclari-ai.md) - AI context management tools (v0.9.0)\n- 🏗 [System Architecture](docs/architecture/architecture-v2.md) - Technical details\n- 🗺️ [Roadmap](ROADMAP.md) - Development roadmap and future plans\n- 💻 [Contributing Guide](docs/development/contributing.md) - How to contribute\n- 🎨 [VS Code Extension](docs/guides/user/vscode-extension.md) - Extension documentation\n\n### AI Assistant Documentation\n- 🌍 [CLAUDE.en.md](CLAUDE.en.md) - English AI assistant guidance\n- 🤖 [CLAUDE.md](CLAUDE.md) - Turkish AI assistant guidance\n- 📋 [MCP Tools Reference](docs/api/MCP_TOOLS_REFERENCE.md) - Detailed MCP tool documentation\n- 📚 [Development History](docs/development/TASKS.md) - Complete project history\n\n## 🏗 Architecture\n\n### Project Structure\n\n```\ngorev/\n├── gorev-mcpserver/        # MCP Server (Go)\n│   ├── cmd/gorev/         # CLI and server entry point\n│   ├── internal/\n│   │   ├── mcp/           # MCP protocol layer\n│   │   └── gorev/        # Business logic\n│   └── test/              # Integration tests\n├── gorev-vscode/           # VS Code Extension (TypeScript)\n│   ├── src/\n│   │   ├── commands/      # VS Code commands\n│   │   ├── providers/     # TreeView providers\n│   │   └── mcp/           # MCP client\n│   └── package.json       # Extension manifest\n└── docs/                   # Project documentation\n```\n\n## 🧪 Development\n\n### Requirements\n- Go 1.23+\n- Make (optional)\n- golangci-lint (for code quality)\n\n### Commands\n\n```bash\n# Download dependencies\nmake deps\n\n# Run tests (90%+ overall coverage)\nmake test\n\n# Coverage report\nmake test-coverage\n\n# Lint check\nmake lint\n\n# Build (all platforms)\nmake build-all\n\n# Docker image\nmake docker-build\n```\n\n## 📊 Project Status\n\n- **Version**: v0.15.5 🚀\n- **Test Coverage**: 90%+ (Major Improvement)\n- **Go Version**: 1.23+\n- **MCP SDK**: mark3labs/mcp-go v0.6.0\n- **Database**: SQLite (embedded)\n- **Security**: Production-ready audit compliant\n- **Thread Safety**: 100% race condition free\n\n## 🤝 Community\n\n- 📦 [GitHub Releases](https://github.com/msenol/gorev/releases)\n- 🐛 [Issue Tracker](https://github.com/msenol/gorev/issues)\n- 💬 [Discussions](https://github.com/msenol/gorev/discussions)\n- 📖 [Wiki](https://github.com/msenol/gorev/wiki)\n\n## 📄 License\n\nThis project is licensed under the [MIT License](LICENSE).\n\n## 🚨 Breaking Change: Template Requirement\n\n**Starting from v0.10.0**, the `gorev_olustur` tool has been removed. All task creation must now use the template system for better structure and consistency.\n\n### Migration Guide\n\n**Before (v0.9.x and earlier):**\n```\nCreate a new task: Fix login bug\n```\n\n**After (v0.10.0+):**\n```\nUse bug-report template to create: Fix login bug\n```\n\nAvailable templates:\n- `bug-report` - Bug reports and fixes\n- `feature` - New features and enhancements  \n- `task` - General tasks and activities\n- `meeting` - Meeting planning and notes\n- `research` - Research and investigation tasks\n\nFor more details, see [MCP Tools Documentation](docs/user-guide/mcp-tools.md#gorev_template_olustur).\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\nMade with ❤️ by [msenol](https://github.com/msenol/gorev/graphs/contributors)\n\n📚 *Documentation enhanced by Claude (Anthropic) - Your AI pair programming assistant*\n\n**[⬆ Back to Top](#-gorev)**\n\n\u003c/div\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmsenol%2Fgorev","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmsenol%2Fgorev","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmsenol%2Fgorev/lists"}