Add support for slash command frontmatter descriptions

src/core/mentions/index.ts

@@ -218,7 +218,12 @@ export async function parseMentions(
 		try {
 			const command = await getCommand(cwd, commandName)
 			if (command) {
-				parsedText += `\n\n<command name="${commandName}">\n${command.content}\n</command>`
+				let commandOutput = ""
+				if (command.description) {
+					commandOutput += `Description: ${command.description}\n\n`
+				}
+				commandOutput += command.content
+				parsedText += `\n\n<command name="${commandName}">\n${commandOutput}\n</command>`
 			} else {
 				parsedText += `\n\n<command name="${commandName}">\nCommand '${commandName}' not found. Available commands can be found in .roo/commands/ or ~/.roo/commands/\n</command>`
 			}

src/core/webview/webviewMessageHandler.ts

@@ -2366,6 +2366,7 @@ export const webviewMessageHandler = async (
 					name: command.name,
 					source: command.source,
 					filePath: command.filePath,
+					description: command.description,
 				}))
 
 				await provider.postMessageToWebview({
@@ -2524,6 +2525,7 @@ export const webviewMessageHandler = async (
 					name: command.name,
 					source: command.source,
 					filePath: command.filePath,
+					description: command.description,
 				}))
 				await provider.postMessageToWebview({
 					type: "commands",

src/i18n/locales/en/common.json

@@ -77,7 +77,7 @@
 		"no_workspace_for_project_command": "No workspace folder found for project command",
 		"command_already_exists": "Command \"{{commandName}}\" already exists",
 		"create_command_failed": "Failed to create command",
-		"command_template_content": "This is a new slash command. Edit this file to customize the command behavior.",
+		"command_template_content": "---\ndescription: \"Brief description of what this command does\"\n---\n\nThis is a new slash command. Edit this file to customize the command behavior.",
 		"claudeCode": {
 			"processExited": "Claude Code process exited with code {{exitCode}}.",
 			"errorOutput": "Error output: {{output}}",

src/package.json

@@ -442,6 +442,7 @@
 		"fzf": "^0.5.2",
 		"get-folder-size": "^5.0.0",
 		"google-auth-library": "^9.15.1",
+		"gray-matter": "^4.0.3",
 		"i18next": "^25.0.0",
 		"ignore": "^7.0.3",
 		"isbinaryfile": "^5.0.2",