feat: add optional editable task titles

packages/types/src/global-settings.ts

@@ -193,6 +193,7 @@ export const globalSettingsSchema = z.object({
 	 * @default "send"
 	 */
 	enterBehavior: z.enum(["send", "newline"]).optional(),
+	taskTitlesEnabled: z.boolean().optional(),
 	profileThresholds: z.record(z.string(), z.number()).optional(),
 	hasOpenedModeSelector: z.boolean().optional(),
 	lastModeExportPath: z.string().optional(),

packages/types/src/history.ts

@@ -10,6 +10,7 @@ export const historyItemSchema = z.object({
 	parentTaskId: z.string().optional(),
 	number: z.number(),
 	ts: z.number(),
+	title: z.string().optional(),
 	task: z.string(),
 	tokensIn: z.number(),
 	tokensOut: z.number(),

src/core/webview/ClineProvider.ts

@@ -1960,6 +1960,7 @@ export class ClineProvider
 			historyPreviewCollapsed,
 			reasoningBlockCollapsed,
 			enterBehavior,
+			taskTitlesEnabled,
 			cloudUserInfo,
 			cloudIsAuthenticated,
 			sharingEnabled,
@@ -2050,6 +2051,7 @@ export class ClineProvider
 			taskHistory: (taskHistory || [])
 				.filter((item: HistoryItem) => item.ts && item.task)
 				.sort((a: HistoryItem, b: HistoryItem) => b.ts - a.ts),
+			taskTitlesEnabled: taskTitlesEnabled ?? false,
 			soundEnabled: soundEnabled ?? false,
 			ttsEnabled: ttsEnabled ?? false,
 			ttsSpeed: ttsSpeed ?? 1.0,
@@ -2358,6 +2360,7 @@ export class ClineProvider
 			historyPreviewCollapsed: stateValues.historyPreviewCollapsed ?? false,
 			reasoningBlockCollapsed: stateValues.reasoningBlockCollapsed ?? true,
 			enterBehavior: stateValues.enterBehavior ?? "send",
+			taskTitlesEnabled: stateValues.taskTitlesEnabled ?? false,
 			cloudUserInfo,
 			cloudIsAuthenticated,
 			sharingEnabled,
@@ -2428,13 +2431,19 @@ export class ClineProvider
 		const existingItemIndex = history.findIndex((h) => h.id === item.id)
 
 		if (existingItemIndex !== -1) {
-			// Preserve existing metadata (e.g., delegation fields) unless explicitly overwritten.
-			// This prevents loss of status/awaitingChildId/delegatedToId when tasks are reopened,
-			// terminated, or when routine message persistence occurs.
-			history[existingItemIndex] = {
-				...history[existingItemIndex],
+			const existingItem = history[existingItemIndex]
+			const hasTitleProp = Object.prototype.hasOwnProperty.call(item, "title")
+			// Preserve existing metadata unless explicitly overwritten.
+			// Title is only cleared when explicitly provided (including undefined).
+			const mergedItem: HistoryItem = {
+				...existingItem,
 				...item,
 			}
+			if (!hasTitleProp) {
+				mergedItem.title = existingItem.title
+			}
+
+			history[existingItemIndex] = mergedItem
 		} else {
 			history.push(item)
 		}

src/core/webview/__tests__/ClineProvider.sticky-mode.spec.ts

@@ -1230,4 +1230,63 @@ describe("ClineProvider - Sticky Mode", () => {
 			})
 		})
 	})
+
+	describe("updateTaskHistory", () => {
+		beforeEach(async () => {
+			await provider.resolveWebviewView(mockWebviewView)
+		})
+
+		it("preserves existing title when update omits the title property", async () => {
+			const baseItem: HistoryItem = {
+				id: "task-with-title",
+				number: 1,
+				ts: Date.now(),
+				task: "Original task",
+				tokensIn: 10,
+				tokensOut: 20,
+				cacheWrites: 0,
+				cacheReads: 0,
+				totalCost: 0,
+				title: "Custom title",
+			}
+
+			await provider.updateTaskHistory(baseItem)
+
+			const itemWithoutTitle = { ...baseItem }
+			delete (itemWithoutTitle as any).title
+			itemWithoutTitle.tokensIn = 42
+
+			await provider.updateTaskHistory(itemWithoutTitle as HistoryItem)
+
+			const history = mockContext.globalState.get("taskHistory") as HistoryItem[]
+			expect(history[0]?.title).toBe("Custom title")
+		})
+
+		it("allows clearing a title when explicitly set to undefined", async () => {
+			const baseItem: HistoryItem = {
+				id: "task-clear-title",
+				number: 1,
+				ts: Date.now(),
+				task: "Another task",
+				tokensIn: 5,
+				tokensOut: 15,
+				cacheWrites: 0,
+				cacheReads: 0,
+				totalCost: 0,
+				title: "Temporary title",
+			}
+
+			await provider.updateTaskHistory(baseItem)
+
+			const clearedItem: HistoryItem = {
+				...baseItem,
+				title: undefined,
+			}
+
+			await provider.updateTaskHistory(clearedItem)
+
+			const history = mockContext.globalState.get("taskHistory") as HistoryItem[]
+			expect(history[0]?.title).toBeUndefined()
+		})
+	})
 })

src/core/webview/webviewMessageHandler.ts

@@ -10,6 +10,7 @@ import {
 	type Language,
 	type GlobalState,
 	type ClineMessage,
+	type HistoryItem,
 	type TelemetrySetting,
 	type UserSettingsConfig,
 	TelemetryEventName,
@@ -728,6 +729,57 @@ export const webviewMessageHandler = async (
 				vscode.window.showErrorMessage(t("common:errors.share_task_failed"))
 			}
 			break
+		case "setTaskTitle": {
+			const ids = Array.isArray(message.ids)
+				? Array.from(
+						new Set(
+							message.ids.filter((id): id is string => typeof id === "string" && id.trim().length > 0),
+						),
+					)
+				: []
+			if (ids.length === 0) {
+				break
+			}
+
+			const rawTitle = message.text ?? ""
+			const trimmedTitle = rawTitle.trim()
+			const normalizedTitle = trimmedTitle.length > 0 ? trimmedTitle : undefined
+			const { taskHistory } = await provider.getState()
+			if (!Array.isArray(taskHistory) || taskHistory.length === 0) {
+				break
+			}
+
+			let hasUpdates = false
+			const historyById = new Map(taskHistory.map((item) => [item.id, item] as const))
+
+			for (const id of ids) {
+				const existingItem = historyById.get(id)
+				if (!existingItem) {
+					console.warn(`[setTaskTitle] Unable to locate task history item with id ${id}`)
+					continue
+				}
+
+				const normalizedExistingTitle =
+					existingItem.title && existingItem.title.trim().length > 0 ? existingItem.title.trim() : undefined
+				if (normalizedExistingTitle === normalizedTitle) {
+					continue
+				}
+
+				const updatedItem: HistoryItem = {
+					...existingItem,
+					title: normalizedTitle,
+				}
+
+				await provider.updateTaskHistory(updatedItem)
+				hasUpdates = true
+			}
+
+			if (hasUpdates) {
+				await provider.postStateToWebview()
+			}
+
+			break
+		}
 		case "showTaskWithId":
 			provider.showTaskWithId(message.text!)
 			break
@@ -1590,7 +1642,6 @@ export const webviewMessageHandler = async (
 			await updateGlobalState("hasOpenedModeSelector", message.bool ?? true)
 			await provider.postStateToWebview()
 			break
-
 		case "toggleApiConfigPin":
 			if (message.text) {
 				const currentPinned = getGlobalState("pinnedApiConfigs") ?? {}

src/shared/ExtensionMessage.ts

@@ -290,6 +290,7 @@ export type ExtensionState = Pick<
 	| "includeCurrentCost"
 	| "maxGitStatusFiles"
 	| "requestDelaySeconds"
+	| "taskTitlesEnabled"
 > & {
 	version: string
 	clineMessages: ClineMessage[]
@@ -330,6 +331,7 @@ export type ExtensionState = Pick<
 	renderContext: "sidebar" | "editor"
 	settingsImportedAt?: number
 	historyPreviewCollapsed?: boolean
+	taskTitlesEnabled?: boolean
 
 	cloudUserInfo: CloudUserInfo | null
 	cloudIsAuthenticated: boolean

src/shared/WebviewMessage.ts

@@ -54,6 +54,7 @@ export interface WebviewMessage {
 		| "importSettings"
 		| "exportSettings"
 		| "resetState"
+		| "setTaskTitle"
 		| "flushRouterModels"
 		| "requestRouterModels"
 		| "requestOpenAiModels"