give_feedback_to_desktop_commander
Open a feedback form to share your experience with Desktop Commander, helping improve the tool's functionality and user experience.
Instructions
Open feedback form in browser to provide feedback about Desktop Commander.
IMPORTANT: This tool simply opens the feedback form - no pre-filling available.
The user will fill out the form manually in their browser.
WORKFLOW:
1. When user agrees to give feedback, just call this tool immediately
2. No need to ask questions or collect information
3. Tool opens form with only usage statistics pre-filled automatically:
- tool_call_count: Number of commands they've made
- days_using: How many days they've used Desktop Commander
- platform: Their operating system (Mac/Windows/Linux)
- client_id: Analytics identifier
All survey questions will be answered directly in the form:
- Job title and technical comfort level
- Company URL for industry context
- Other AI tools they use
- Desktop Commander's biggest advantage
- How they typically use it
- Recommendation likelihood (0-10)
- User study participation interest
- Email and any additional feedback
EXAMPLE INTERACTION:
User: "sure, I'll give feedback"
Claude: "Perfect! Let me open the feedback form for you."
[calls tool immediately]
No parameters are needed - just call the tool to open the form.
This command can be referenced as "DC: ..." or "use Desktop Commander to ..." in your instructions.Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/tools/feedback.ts:19-97 (handler)The primary handler function implementing the tool. Opens browser to Tally.so feedback form pre-filled with usage stats, handles cross-platform browser opening, captures analytics.
export async function giveFeedbackToDesktopCommander(params: FeedbackParams = {}): Promise<ServerResult> { try { // Get usage stats for context const stats = await usageTracker.getStats(); // Capture feedback tool usage event await capture('feedback_tool_called', { total_calls: stats.totalToolCalls, successful_calls: stats.successfulCalls, failed_calls: stats.failedCalls, days_since_first_use: Math.floor((Date.now() - stats.firstUsed) / (1000 * 60 * 60 * 24)), total_sessions: stats.totalSessions, platform: os.platform(), }); // Build Tally.so URL with pre-filled parameters const tallyUrl = await buildTallyUrl(params, stats); // Open URL in default browser const success = await openUrlInBrowser(tallyUrl); if (success) { // Capture successful browser opening await capture('feedback_form_opened_successfully', { total_calls: stats.totalToolCalls, platform: os.platform() }); // Mark that user has given feedback (or at least opened the form) await usageTracker.markFeedbackGiven(); return { content: [{ type: "text", text: `🎉 **Feedback form opened in your browser!**\n\n` + `Thank you for taking the time to share your experience with Desktop Commander. ` + `Your feedback helps us build better features and improve the tool for everyone.\n\n` + `The form has been pre-filled with the information you provided. ` + `You can modify or add any additional details before submitting.\n\n` + `**Form URL**: ${tallyUrl.length > 100 ? tallyUrl.substring(0, 100) + '...' : tallyUrl}` }] }; } else { // Capture browser opening failure await capture('feedback_form_open_failed', { total_calls: stats.totalToolCalls, platform: os.platform(), error_type: 'browser_open_failed' }); return { content: [{ type: "text", text: `⚠️ **Couldn't open browser automatically**\n\n` + `Please copy and paste this URL into your browser to access the feedback form:\n\n` + `${tallyUrl}\n\n` + `The form has been pre-filled with your information. Thank you for your feedback!` }] }; } } catch (error) { // Capture error event await capture('feedback_tool_error', { error_message: error instanceof Error ? error.message : String(error), error_type: error instanceof Error ? error.constructor.name : 'unknown' }); return { content: [{ type: "text", text: `❌ **Error opening feedback form**: ${error instanceof Error ? error.message : String(error)}\n\n` + `You can still access our feedback form directly at: https://tally.so/r/mKqoKg\n\n` + `We appreciate your willingness to provide feedback!` }], isError: true }; } } - src/server.ts:1010-1050 (registration)Tool registration in the allTools array used by listTools handler. Defines name, description, input schema, and annotations.
name: "give_feedback_to_desktop_commander", description: ` Open feedback form in browser to provide feedback about Desktop Commander. IMPORTANT: This tool simply opens the feedback form - no pre-filling available. The user will fill out the form manually in their browser. WORKFLOW: 1. When user agrees to give feedback, just call this tool immediately 2. No need to ask questions or collect information 3. Tool opens form with only usage statistics pre-filled automatically: - tool_call_count: Number of commands they've made - days_using: How many days they've used Desktop Commander - platform: Their operating system (Mac/Windows/Linux) - client_id: Analytics identifier All survey questions will be answered directly in the form: - Job title and technical comfort level - Company URL for industry context - Other AI tools they use - Desktop Commander's biggest advantage - How they typically use it - Recommendation likelihood (0-10) - User study participation interest - Email and any additional feedback EXAMPLE INTERACTION: User: "sure, I'll give feedback" Claude: "Perfect! Let me open the feedback form for you." [calls tool immediately] No parameters are needed - just call the tool to open the form. ${CMD_PREFIX_DESCRIPTION}`, inputSchema: zodToJsonSchema(GiveFeedbackArgsSchema), annotations: { title: "Give Feedback", readOnlyHint: false, openWorldHint: true, }, }, - src/tools/schemas.ts:158-165 (schema)Zod schema definition for tool input parameters (empty object as no user params required).
export const GiveFeedbackArgsSchema = z.object({ // No parameters needed - form will be filled manually by user // Only auto-filled hidden fields remain: // - tool_call_count (auto) // - days_using (auto) // - platform (auto) // - client_id (auto) }); - src/server.ts:171-181 (registration)Conditional registration logic that excludes the tool when the connected client is 'desktop-commander'.
function shouldIncludeTool(toolName: string): boolean { // Exclude give_feedback_to_desktop_commander for desktop-commander client if (toolName === 'give_feedback_to_desktop_commander' && currentClient?.name === 'desktop-commander') { return false; } // Add more conditional tool logic here as needed // Example: if (toolName === 'some_tool' && currentClient?.name === 'some_client') return false; return true; } - src/server.ts:1229-1238 (handler)Dispatch handler in CallToolRequestSchema that invokes the main handler function.
case "give_feedback_to_desktop_commander": try { result = await giveFeedbackToDesktopCommander(args); } catch (error) { capture('server_request_error', { message: `Error in give_feedback_to_desktop_commander handler: ${error}` }); result = { content: [{ type: "text", text: `Error: Failed to open feedback form` }], isError: true, }; }