tauri_debug_command
Execute debug commands on Tauri apps over WebSocket: manage app lifecycle, inspect tasks, run UI automation, and retrieve logs/metrics.
Instructions
Debug and inspect Tauri applications via WebSocket.
MULTI-APP SUPPORT: This tool can connect to any Tauri app with a debug WebSocket endpoint.
Available apps: commander, photon
Default app: commander
Use "app" parameter to specify which app to connect to
QUICK REFERENCE:
Lifecycle: start_app, kill_app
Health: test_connection, get_debug_mode
Tasks: get_task, get_tasks_by_status, get_task_metrics, get_all_tasks (Commander only)
Sessions: get_session_metrics, list_windows (Commander only)
System: get_system_metrics, get_app_dir, get_logs
Actions: broadcast_to_frontend, set_debug_mode (Commander only)
UI Automation: click, fill, select, type, press_key, get_snapshot, take_screenshot, wait_for, hover, scroll, get_console_logs
FILTERING TASKS (avoid loading all tasks): { "command": "get_task", "params": { "task_id": 123 } } { "command": "get_tasks_by_status", "params": { "status": "working" } } { "command": "get_all_tasks", "params": { "status": "pending", "limit": 20 } } { "command": "get_all_tasks", "params": { "recent_only": true } }
RESPONSE FORMAT: Add response_format: "concise" (default) or "detailed" to control verbosity.
concise: Truncates arrays to 20 items, includes metadata about truncation
detailed: Returns full data without truncation
APP LIFECYCLE COMMANDS:
"start_app": Start a Tauri application (optional: path, command, args, env, timeout, waitForConnection)
"kill_app": Kill a running Tauri application (optional: force, timeout)
CORE COMMANDS (all apps):
"test_connection": Check Tauri bridge connectivity
"get_debug_mode": Get current debug mode status
"set_debug_mode": Enable/disable debug mode (requires enabled: boolean)
"get_app_dir": Get application directory paths
"get_logs": Get recent application logs
"get_system_metrics": Get system resource metrics
"test_command": Test command execution (requires command: string)
"simple_test": Run a simple test command
COMMANDER-SPECIFIC COMMANDS:
"get_task": Get single task by ID (requires task_id: number)
"get_tasks_by_status": Get tasks filtered by status (requires status: string)
"get_all_tasks": Get tasks with optional filtering (status?, limit?, recent_only?)
"get_task_metrics": Get task count breakdown by status
"get_task_groups": Get task groups/initiatives with progress
"get_session_metrics": Get active sessions list
"list_windows": List connected WebSocket clients
"broadcast_to_frontend": Send message to frontend (requires action, payload)
UI AUTOMATION COMMANDS:
"click": Click element (requires uid: string)
"fill": Clear and fill input element (requires uid: string, value: string)
"select": Select dropdown option (requires uid: string, value: string)
"type": Type text into element (requires uid: string, text: string)
"press_key": Press keyboard key or combination (requires key: string)
"get_snapshot": Get accessibility tree snapshot (returns interactive elements with refs)
"take_screenshot": Take page screenshot (optional: full_page: boolean, path: string)
"wait_for": Wait for text or element (requires text_or_selector: string, timeout?: number)
"hover": Hover over element (requires uid: string)
"scroll": Scroll page or element (requires direction: string, amount?: number)
"get_console_logs": Get browser/frontend console messages (optional: types[], limit, includePreservedLogs)
EXAMPLES: { "command": "start_app", "app": "photon" } { "command": "start_app", "app": "photon", "params": { "command": "cargo tauri dev", "waitForConnection": true } } { "command": "kill_app", "app": "photon" } { "command": "kill_app", "app": "photon", "params": { "force": true } } { "command": "test_connection" } { "command": "test_connection", "app": "photon" } { "command": "get_task", "params": { "task_id": 42 } } { "command": "get_tasks_by_status", "params": { "status": "working" } } { "command": "get_all_tasks", "params": { "limit": 10 }, "response_format": "detailed" } { "command": "broadcast_to_frontend", "params": { "action": "execute_js", "payload": { "script": "document.title" } } } { "command": "get_snapshot" } { "command": "click", "params": { "uid": "e5" } } { "command": "fill", "params": { "uid": "e3", "value": "test@example.com" } } { "command": "take_screenshot", "params": { "full_page": true } } { "command": "get_console_logs", "params": { "types": ["error", "warn"], "limit": 50 } }
RESPONSE: Returns { success: boolean, data?: unknown, error?: string }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| app | No | Target app to debug. Available: commander, photon. Default: commander | commander |
| params | No | Command parameters (varies by command) | |
| command | Yes | Debug command to execute | |
| response_format | No | Output verbosity: concise=minimal output, detailed=full data | concise |