rtaskmaster-mcp 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 RBuildAI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,244 @@
+# RTaskmaster MCP
+
+A task master MCP (Model Context Protocol) server for AI-driven development in VS Code, Cursor, and other MCP-compatible editors.
+
+[![npm version](https://badge.fury.io/js/rtaskmaster-mcp.svg)](https://www.npmjs.com/package/rtaskmaster-mcp)
+
+## Features
+
+- 📋 **Task Management**: Create, update, list, and organize tasks
+- 🎯 **Subtasks**: Break down complex tasks into manageable subtasks
+- 📊 **Status Tracking**: Track progress with status updates (pending, in-progress, done, blocked, deferred)
+- 🏷️ **Priority Levels**: Organize by priority (high, medium, low)
+- 🔗 **Dependencies**: Define task dependencies
+- 💾 **JSON Storage**: Simple file-based storage in `.rtaskmaster/tasks.json`
+- 🤖 **AI-Ready**: Designed to work seamlessly with GitHub Copilot, Claude, and other AI assistants
+
+## Quick Install for VS Code
+
+### Option 1: NPX (Recommended - No Install Required)
+
+Add to your VS Code MCP configuration at `.vscode/mcp.json` in your project:
+
+```json
+{
+  "servers": {
+    "rtaskmaster": {
+      "command": "npx",
+      "args": ["-y", "rtaskmaster-mcp"],
+      "type": "stdio"
+    }
+  }
+}
+```
+
+### Option 2: Global Install
+
+```bash
+npm install -g rtaskmaster-mcp
+```
+
+Then add to `.vscode/mcp.json`:
+
+```json
+{
+  "servers": {
+    "rtaskmaster": {
+      "command": "rtaskmaster-mcp",
+      "type": "stdio"
+    }
+  }
+}
+```
+
+### Option 3: Cursor IDE
+
+Add to `~/.cursor/mcp.json` or your project's `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "rtaskmaster": {
+      "command": "npx",
+      "args": ["-y", "rtaskmaster-mcp"]
+    }
+  }
+}
+```
+
+## 📖 AI Agent Instructions
+
+For AI agents (GitHub Copilot, Claude, etc.) to work effectively with RTaskmaster, reference the instructions file:
+
+**Location**: `.github/instructions.md` in this repository
+
+The instructions file provides:
+
+- ✅ Getting started workflow
+- ✅ Task lifecycle management
+- ✅ Best practices for AI agents
+- ✅ TASKS.md checklist format
+- ✅ Example sessions
+
+### Quick Workflow for AI Agents
+
+1. **Initialize**: `rtaskmaster_init` at project start
+2. **Create tasks**: Break down requirements into tasks
+3. **Generate checklist**: `rtaskmaster_generate_tasks_md` for human-readable view
+4. **Work loop**: `rtaskmaster_next_task` → work → `rtaskmaster_set_status` → repeat
+5. **Track progress**: `rtaskmaster_stats` to see completion
+
+## Available MCP Tools
+
+| Tool                           | Description                                  |
+| ------------------------------ | -------------------------------------------- |
+| `rtaskmaster_init`              | Initialize RTaskmaster in a project           |
+| `rtaskmaster_get_tasks`         | Get all tasks with optional filtering        |
+| `rtaskmaster_get_task`          | Get a specific task by ID                    |
+| `rtaskmaster_create_task`       | Create a new task                            |
+| `rtaskmaster_update_task`       | Update an existing task                      |
+| `rtaskmaster_delete_task`       | Delete a task                                |
+| `rtaskmaster_set_status`        | Update task status                           |
+| `rtaskmaster_add_subtask`       | Add a subtask to a task                      |
+| `rtaskmaster_next_task`         | Get the next task to work on                 |
+| `rtaskmaster_stats`             | Get project statistics                       |
+| `rtaskmaster_generate_tasks_md` | Generate a human-readable TASKS.md checklist |
+| `rtaskmaster_parse_prd`         | Parse requirements/PRD files to create tasks |
+| `rtaskmaster_bulk_status`       | Update multiple task statuses at once        |
+
+## 📋 TASKS.md Checklist File
+
+RTaskmaster can generate a human-readable `TASKS.md` file that serves as a visual checklist:
+
+```markdown
+# Project Tasks
+
+## 📊 Progress
+
+| Status         | Count |
+| -------------- | ----- |
+| ✅ Done        | 2     |
+| 🔄 In Progress | 1     |
+| ⏳ Pending     | 3     |
+| **Total**      | **6** |
+
+**Completion: 33%**
+
+---
+
+## ✅ Tasks
+
+### 🔴 High Priority
+
+- [x] Set up project structure (#1)
+- [ ] 🔄 Implement authentication (#2)
+  - [x] Set up OAuth (#2.1)
+  - [ ] Add JWT tokens (#2.2)
+
+### 🟡 Medium Priority
+
+- [ ] Add user profile page (#3)
+```
+
+Generate this file anytime using `rtaskmaster_generate_tasks_md`.
+
+## Task Structure
+
+Tasks are stored in `.rtaskmaster/tasks.json`:
+
+```json
+{
+  "version": "1.0.0",
+  "projectName": "My Project",
+  "tasks": [
+    {
+      "id": "1",
+      "title": "Implement authentication",
+      "description": "Add user authentication system",
+      "status": "pending",
+      "priority": "high",
+      "dependencies": [],
+      "subtasks": [
+        {
+          "id": "1",
+          "title": "Set up OAuth",
+          "status": "pending"
+        }
+      ],
+      "details": "Implementation notes here...",
+      "testStrategy": "How to verify this task...",
+      "createdAt": "2026-01-13T10:00:00.000Z",
+      "updatedAt": "2026-01-13T10:00:00.000Z"
+    }
+  ],
+  "lastUpdated": "2026-01-13T10:00:00.000Z"
+}
+```
+
+## Usage Examples
+
+Once configured, interact through your AI assistant:
+
+```
+Initialize taskmaster in this project
+
+Create a task to implement user authentication with high priority
+
+Show me all pending tasks
+
+What's the next task I should work on?
+
+Mark task 1 as in-progress
+
+Add a subtask to task 1: "Set up database schema"
+```
+
+## Task Statuses
+
+| Status        | Description                           |
+| ------------- | ------------------------------------- |
+| `pending`     | Task not yet started                  |
+| `in-progress` | Currently being worked on             |
+| `done`        | Completed                             |
+| `blocked`     | Cannot proceed (waiting on something) |
+| `deferred`    | Postponed for later                   |
+
+## Priority Levels
+
+| Priority | Description               |
+| -------- | ------------------------- |
+| `high`   | Urgent/critical tasks     |
+| `medium` | Normal priority (default) |
+| `low`    | Can wait                  |
+
+## Development
+
+```bash
+# Clone the repo
+git clone https://github.com/RagnarPitla/RTaskmaster-rbuildai-mcp.git
+cd RTaskmaster-rbuildai-mcp
+
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Watch mode for development
+npm run dev
+
+# Test with MCP Inspector
+npm run inspector
+```
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+MIT
+
+## Author
+
+RBuildAI - [GitHub](https://github.com/RagnarPitla)

package/dist/core/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Core module exports
+ */
+export * from './types.js';
+export * from './storage.js';
+export * from './task-manager.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,7 @@
+/**
+ * Core module exports
+ */
+export * from './types.js';
+export * from './storage.js';
+export * from './task-manager.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC"}

package/dist/core/storage.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Task Storage - File-based JSON storage for tasks
+ */
+import type { Task, TaskStore } from './types.js';
+export declare class TaskStorage {
+    private projectRoot;
+    private tasksPath;
+    constructor(projectRoot: string);
+    /**
+     * Check if RTaskmaster is initialized in the project
+     */
+    isInitialized(): boolean;
+    /**
+     * Initialize RTaskmaster in the project
+     */
+    initialize(projectName?: string): TaskStore;
+    /**
+     * Load task store from disk
+     */
+    load(): TaskStore;
+    /**
+     * Save task store to disk
+     */
+    save(store: TaskStore): void;
+    /**
+     * Get all tasks
+     */
+    getTasks(): Task[];
+    /**
+     * Save all tasks
+     */
+    saveTasks(tasks: Task[]): void;
+    /**
+     * Get project root
+     */
+    getProjectRoot(): string;
+}
+//# sourceMappingURL=storage.d.ts.map

package/dist/core/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/core/storage.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAMlD,qBAAa,WAAW;IACtB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAS;gBAEd,WAAW,EAAE,MAAM;IAK/B;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,UAAU,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS;IAyB3C;;OAEG;IACH,IAAI,IAAI,SAAS;IAWjB;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAM5B;;OAEG;IACH,QAAQ,IAAI,IAAI,EAAE;IAIlB;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI;IAM9B;;OAEG;IACH,cAAc,IAAI,MAAM;CAGzB"}

package/dist/core/storage.js

@@ -0,0 +1,83 @@
+/**
+ * Task Storage - File-based JSON storage for tasks
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+const RTASKMASTER_DIR = '.rtaskmaster';
+const TASKS_FILE = 'tasks.json';
+const VERSION = '1.0.0';
+export class TaskStorage {
+    projectRoot;
+    tasksPath;
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot;
+        this.tasksPath = path.join(projectRoot, RTASKMASTER_DIR, TASKS_FILE);
+    }
+    /**
+     * Check if RTaskmaster is initialized in the project
+     */
+    isInitialized() {
+        return fs.existsSync(this.tasksPath);
+    }
+    /**
+     * Initialize RTaskmaster in the project
+     */
+    initialize(projectName) {
+        const rtaskmasterDir = path.join(this.projectRoot, RTASKMASTER_DIR);
+        if (!fs.existsSync(rtaskmasterDir)) {
+            fs.mkdirSync(rtaskmasterDir, { recursive: true });
+        }
+        const store = {
+            version: VERSION,
+            projectName: projectName || path.basename(this.projectRoot),
+            tasks: [],
+            lastUpdated: new Date().toISOString(),
+        };
+        this.save(store);
+        // Create .gitignore in .rtaskmaster if it doesn't exist
+        const gitignorePath = path.join(rtaskmasterDir, '.gitignore');
+        if (!fs.existsSync(gitignorePath)) {
+            fs.writeFileSync(gitignorePath, '# RTaskmaster files to ignore\n');
+        }
+        return store;
+    }
+    /**
+     * Load task store from disk
+     */
+    load() {
+        if (!this.isInitialized()) {
+            throw new Error('RTaskmaster is not initialized in this project. Run rtaskmaster_init first.');
+        }
+        const content = fs.readFileSync(this.tasksPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    /**
+     * Save task store to disk
+     */
+    save(store) {
+        store.lastUpdated = new Date().toISOString();
+        const content = JSON.stringify(store, null, 2);
+        fs.writeFileSync(this.tasksPath, content, 'utf-8');
+    }
+    /**
+     * Get all tasks
+     */
+    getTasks() {
+        return this.load().tasks;
+    }
+    /**
+     * Save all tasks
+     */
+    saveTasks(tasks) {
+        const store = this.load();
+        store.tasks = tasks;
+        this.save(store);
+    }
+    /**
+     * Get project root
+     */
+    getProjectRoot() {
+        return this.projectRoot;
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/core/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/core/storage.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC,MAAM,eAAe,GAAG,cAAc,CAAC;AACvC,MAAM,UAAU,GAAG,YAAY,CAAC;AAChC,MAAM,OAAO,GAAG,OAAO,CAAC;AAExB,MAAM,OAAO,WAAW;IACd,WAAW,CAAS;IACpB,SAAS,CAAS;IAE1B,YAAY,WAAmB;QAC7B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC;IACvE,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,WAAoB;QAC7B,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;QAEpE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;YACnC,EAAE,CAAC,SAAS,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC;QAED,MAAM,KAAK,GAAc;YACvB,OAAO,EAAE,OAAO;YAChB,WAAW,EAAE,WAAW,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC;YAC3D,KAAK,EAAE,EAAE;YACT,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACtC,CAAC;QAEF,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEjB,wDAAwD;QACxD,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;QAC9D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YAClC,EAAE,CAAC,aAAa,CAAC,aAAa,EAAE,iCAAiC,CAAC,CAAC;QACrE,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,IAAI;QACF,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CACb,6EAA6E,CAC9E,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACzD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAc,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,KAAgB;QACnB,KAAK,CAAC,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC/C,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,KAAa;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC1B,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;CACF"}

package/dist/core/task-manager.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Task Manager - Core business logic for task operations
+ */
+import type { Task, Subtask, TaskStatus, TaskFilter, TaskStats, CreateTaskInput, UpdateTaskInput, CreateSubtaskInput } from './types.js';
+export declare class TaskManager {
+    private storage;
+    constructor(projectRoot: string);
+    /**
+     * Check if initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Initialize Ragnar
+     */
+    initialize(projectName?: string): import("./types.js").TaskStore;
+    /**
+     * Generate next task ID
+     */
+    private generateTaskId;
+    /**
+     * Generate next subtask ID
+     */
+    private generateSubtaskId;
+    /**
+     * Get all tasks with optional filtering
+     */
+    getTasks(filter?: TaskFilter): Task[];
+    /**
+     * Get a task by ID (supports dot notation for subtasks: "1.2")
+     */
+    getTask(taskId: string): Task | Subtask | null;
+    /**
+     * Get parent task (for subtask operations)
+     */
+    getParentTask(taskId: string): Task | null;
+    /**
+     * Create a new task
+     */
+    createTask(input: CreateTaskInput): Task;
+    /**
+     * Update an existing task
+     */
+    updateTask(taskId: string, input: UpdateTaskInput): Task | null;
+    /**
+     * Delete a task
+     */
+    deleteTask(taskId: string): boolean;
+    /**
+     * Set task status
+     */
+    setStatus(taskId: string, status: TaskStatus): Task | Subtask | null;
+    /**
+     * Add a subtask to a task
+     */
+    addSubtask(taskId: string, input: CreateSubtaskInput): Subtask | null;
+    /**
+     * Get the next task to work on
+     * Prioritizes: in-progress > high priority pending > medium > low
+     * Only returns tasks with satisfied dependencies
+     */
+    getNextTask(): Task | null;
+    /**
+     * Get task statistics
+     */
+    getStats(): TaskStats;
+}
+//# sourceMappingURL=task-manager.d.ts.map

package/dist/core/task-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-manager.d.ts","sourceRoot":"","sources":["../../src/core/task-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EACV,IAAI,EACJ,OAAO,EACP,UAAU,EACV,UAAU,EACV,SAAS,EACT,eAAe,EACf,eAAe,EACf,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAc;gBAEjB,WAAW,EAAE,MAAM;IAI/B;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,UAAU,CAAC,WAAW,CAAC,EAAE,MAAM;IAI/B;;OAEG;IACH,OAAO,CAAC,cAAc;IAMtB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,EAAE;IAiBrC;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,GAAG,IAAI;IAc9C;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAM1C;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAwBxC;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,IAAI;IAmB/D;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAiBnC;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,GAAG,IAAI;IA+BpE;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,GAAG,IAAI;IAuBrE;;;;OAIG;IACH,WAAW,IAAI,IAAI,GAAG,IAAI;IAuC1B;;OAEG;IACH,QAAQ,IAAI,SAAS;CAkBtB"}