Feat: Task Favorites ⭐️ (RooCodeInc#3392)

* Task Favorites

* Task management docs

Author: canvrno

.changeset/selfish-garlics-lay.md

@@ -0,0 +1,5 @@
+---
+"claude-dev": minor
+---
+
+Add Task Favorites and several proto messages related to tasks

docs/docs.json

@@ -62,6 +62,7 @@
 					"getting-started/installing-dev-essentials",
 					"getting-started/model-selection-guide",
 					"getting-started/our-favorite-tech-stack",
+					"getting-started/task-management",
 					"getting-started/understanding-context-management",
 					"getting-started/what-is-cline"
 				]

docs/getting-started/task-management.mdx

@@ -0,0 +1,67 @@
+---
+title: "Task Management in Cline"
+description: "Learn how to effectively manage your task history, use favorites, and organize your work in Cline."
+---
+
+# Task Management
+
+As you use Cline, you'll accumulate many tasks over time. The task management system helps you organize, filter, search, and clean up your task history to keep your workspace efficient.
+
+## Accessing Task History
+
+You can access your task history by:
+
+1. Clicking on the "History" button in the Cline sidebar
+2. Using the command palette to search for "Cline: Show Task History"
+
+## Task History Features
+
+The task history view provides several powerful features:
+
+### Searching and Filtering
+
+-   **Search Bar**: Use the fuzzy search at the top to quickly find tasks by content
+-   **Sort Options**: Sort tasks by:
+    -   Newest (default)
+    -   Oldest
+    -   Most Expensive (highest API cost)
+    -   Most Tokens (highest token usage)
+    -   Most Relevant (when searching)
+-   **Favorites Filter**: Toggle to show only favorited tasks
+
+### Task Actions
+
+Each task in the history view has several actions available:
+
+-   **Open**: Click on a task to reopen it in the Cline chat
+-   **Favorite**: Click the star icon to mark a task as a favorite
+-   **Delete**: Remove individual tasks (favorites are protected from deletion)
+-   **Export**: Export a task's conversation to markdown
+
+## ⭐ Task Favorites
+
+The favorites feature allows you to mark important tasks that you want to preserve and find quickly.
+
+### How Favorites Work
+
+-   **Marking Favorites**: Click the star icon next to any task to toggle its favorite status
+-   **Protection**: Favorited tasks are protected from individual and bulk deletion operations (can be overridden)
+-   **Filtering**: Use the favorites filter to quickly access your important tasks
+
+## Batch Operations
+
+The task history view supports several batch operations:
+
+-   **Select Multiple**: Use the checkboxes to select multiple tasks
+-   **Select All/None**: Quickly select or deselect all tasks
+-   **Delete Selected**: Remove all selected tasks
+-   **Delete All**: Remove all tasks from history (favorites are preserved unless you choose to include them)
+
+## Best Practices
+
+1. **Favorite Important Tasks**: Mark reference tasks or frequently accessed conversations as favorites
+2. **Regular Cleanup**: Periodically remove old or unused tasks to improve performance
+3. **Use Search**: Leverage the fuzzy search to quickly find specific conversations
+4. **Export Valuable Tasks**: Export important tasks to markdown for external reference
+
+Task management helps you maintain an organized workflow when using Cline, allowing you to quickly find past conversations, preserve important work, and keep your history clean and efficient.

proto/task.proto

@@ -16,9 +16,15 @@ service TaskService {
   // Creates a new task with the given text and optional images
   rpc newTask(NewTaskRequest) returns (Empty);
   // Shows a task with the specified ID
-  rpc showTaskWithId(StringRequest) returns (Empty);
+  rpc showTaskWithId(StringRequest) returns (TaskResponse);
   // Exports a task with the given ID to markdown
   rpc exportTaskWithId(StringRequest) returns (Empty);
+  // Toggles the favorite status of a task
+  rpc toggleTaskFavorite(TaskFavoriteRequest) returns (Empty);
+  // Deletes all non-favorited tasks
+  rpc deleteNonFavoritedTasks(EmptyRequest) returns (DeleteNonFavoritedTasksResults);
+  // Gets filtered task history
+  rpc getTaskHistory(GetTaskHistoryRequest) returns (TaskHistoryArray);
 }
 
 // Request message for creating a new task
@@ -27,3 +33,58 @@ message NewTaskRequest {
   string text = 2;
   repeated string images = 3;
 }
+
+// Request message for toggling task favorite status
+message TaskFavoriteRequest {
+  Metadata metadata = 1;
+  string task_id = 2;
+  bool is_favorited = 3;
+}
+
+// Response for task details
+message TaskResponse {
+  string id = 1;
+  string task = 2;
+  int64 ts = 3;
+  bool is_favorited = 4;
+  int64 size = 5;
+  double total_cost = 6;
+  int32 tokens_in = 7;
+  int32 tokens_out = 8;
+  int32 cache_writes = 9;
+  int32 cache_reads = 10;
+}
+
+// Results returned when deleting non-favorited tasks
+message DeleteNonFavoritedTasksResults {
+  int32 tasks_preserved = 1;
+  int32 tasks_deleted = 2;
+}
+
+// Request for getting task history with filtering
+message GetTaskHistoryRequest {
+  Metadata metadata = 1;
+  bool favorites_only = 2;
+  string search_query = 3;
+  string sort_by = 4;
+}
+
+// Response for task history
+message TaskHistoryArray {
+  repeated TaskItem tasks = 1;
+  int32 total_count = 2;
+}
+
+// Task item details for history list
+message TaskItem {
+  string id = 1;
+  string task = 2;
+  int64 ts = 3;
+  bool is_favorited = 4;
+  int64 size = 5;
+  double total_cost = 6;
+  int32 tokens_in = 7;
+  int32 tokens_out = 8;
+  int32 cache_writes = 9;
+  int32 cache_reads = 10;
+}

src/core/controller/index.ts

@@ -597,11 +597,18 @@ export class Controller {
 			}
 			case "clearAllTaskHistory": {
 				const answer = await vscode.window.showWarningMessage(
-					"Are you sure you want to delete all history?",
-					"Delete",
+					"What would you like to delete?",
+					{ modal: true },
+					"Delete All Except Favorites",
+					"Delete Everything",
 					"Cancel",
 				)
-				if (answer === "Delete") {
+
+				if (answer === "Delete All Except Favorites") {
+					await this.deleteNonFavoriteTaskHistory()
+					await this.postStateToWebview()
+					this.refreshTotalTasksSize()
+				} else if (answer === "Delete Everything") {
 					await this.deleteAllTaskHistory()
 					await this.postStateToWebview()
 					this.refreshTotalTasksSize()
@@ -1538,6 +1545,43 @@ Here is the project's README to help you get started:\n\n${mcpDetails.readmeCont
 		// await this.postStateToWebview()
 	}
 
+	async deleteNonFavoriteTaskHistory() {
+		await this.clearTask()
+
+		const taskHistory = ((await getGlobalState(this.context, "taskHistory")) as HistoryItem[]) || []
+		const favoritedTasks = taskHistory.filter((task) => task.isFavorited === true)
+
+		// If user has no favorited tasks, show a warning message
+		if (favoritedTasks.length === 0) {
+			vscode.window.showWarningMessage("No favorited tasks found. Please favorite tasks before using this option.")
+			await this.postStateToWebview()
+			return
+		}
+
+		await updateGlobalState(this.context, "taskHistory", favoritedTasks)
+
+		// Delete non-favorited task directories
+		try {
+			const preserveTaskIds = favoritedTasks.map((task) => task.id)
+			const taskDirPath = path.join(this.context.globalStorageUri.fsPath, "tasks")
+
+			if (await fileExistsAtPath(taskDirPath)) {
+				const taskDirs = await fs.readdir(taskDirPath)
+				for (const taskDir of taskDirs) {
+					if (!preserveTaskIds.includes(taskDir)) {
+						await fs.rm(path.join(taskDirPath, taskDir), { recursive: true, force: true })
+					}
+				}
+			}
+		} catch (error) {
+			vscode.window.showErrorMessage(
+				`Error deleting task history: ${error instanceof Error ? error.message : String(error)}`,
+			)
+		}
+
+		await this.postStateToWebview()
+	}
+
 	async refreshTotalTasksSize() {
 		getTotalTasksSize(this.context.globalStorageUri.fsPath)
 			.then((newTotalSize) => {

src/core/controller/task/deleteNonFavoritedTasks.ts

@@ -0,0 +1,88 @@
+import path from "path"
+import fs from "fs/promises"
+import { Controller } from ".."
+import { EmptyRequest } from "../../../shared/proto/common"
+import { DeleteNonFavoritedTasksResults } from "../../../shared/proto/task"
+import { getGlobalState, updateGlobalState } from "../../storage/state"
+import { fileExistsAtPath } from "../../../utils/fs"
+
+/**
+ * Deletes all non-favorited tasks, preserving only favorited ones
+ * @param controller The controller instance
+ * @param request Empty request
+ * @returns DeleteNonFavoritedTasksResults with counts of preserved and deleted tasks
+ */
+export async function deleteNonFavoritedTasks(
+	controller: Controller,
+	_request: EmptyRequest,
+): Promise<DeleteNonFavoritedTasksResults> {
+	try {
+		// Clear current task first
+		await controller.clearTask()
+
+		// Get existing task history
+		const taskHistory = ((await getGlobalState(controller.context, "taskHistory")) as any[]) || []
+
+		// Filter out non-favorited tasks
+		const favoritedTasks = taskHistory.filter((task) => task.isFavorited === true)
+		const deletedCount = taskHistory.length - favoritedTasks.length
+
+		console.log(`[deleteNonFavoritedTasks] Found ${favoritedTasks.length} favorited tasks to preserve`)
+
+		// Update global state
+		if (favoritedTasks.length > 0) {
+			await updateGlobalState(controller.context, "taskHistory", favoritedTasks)
+		} else {
+			await updateGlobalState(controller.context, "taskHistory", undefined)
+		}
+
+		// Handle file system cleanup for deleted tasks
+		const preserveTaskIds = favoritedTasks.map((task) => task.id)
+		await cleanupTaskFiles(controller, preserveTaskIds)
+
+		// Update webview
+		try {
+			await controller.postStateToWebview()
+		} catch (webviewErr) {
+			console.error("Error posting to webview:", webviewErr)
+		}
+
+		return {
+			tasksPreserved: favoritedTasks.length,
+			tasksDeleted: deletedCount,
+		}
+	} catch (error) {
+		console.error("Error in deleteNonFavoritedTasks:", error)
+		throw error
+	}
+}
+
+/**
+ * Helper function to cleanup task files while preserving specified tasks
+ */
+async function cleanupTaskFiles(controller: Controller, preserveTaskIds: string[]) {
+	const taskDirPath = path.join(controller.context.globalStorageUri.fsPath, "tasks")
+
+	try {
+		if (await fileExistsAtPath(taskDirPath)) {
+			if (preserveTaskIds.length > 0) {
+				const taskDirs = await fs.readdir(taskDirPath)
+				console.debug(`[cleanupTaskFiles] Found ${taskDirs.length} task directories`)
+
+				// Delete only non-preserved task directories
+				for (const dir of taskDirs) {
+					if (!preserveTaskIds.includes(dir)) {
+						await fs.rm(path.join(taskDirPath, dir), { recursive: true, force: true })
+					}
+				}
+			} else {
+				// No tasks to preserve, delete everything
+				await fs.rm(taskDirPath, { recursive: true, force: true })
+			}
+		}
+	} catch (error) {
+		console.error("Error cleaning up task files:", error)
+	}
+
+	return true
+}