cancel_job desktop destructive
Cancel a running async PowerShell job. Use this to stop long-running commands that are no longer needed.
Parameters
job_id: string- Job ID of the job to cancel
dev — Desktop Development Tools
31 MCP tools.
Machine-readable: /reference/api/tools/dev.json
Tools
config_add_safe_dir desktop confirm destructive
Add a directory to the safe directories list, allowing file operations in that path.
Parameters
path: string- Directory path to add (e.g., 'C:\Projects\NewRepo')
validate_exists: boolean (optional)- Check if directory exists before adding — default:
true
config_apply_preset desktop confirm destructive
Apply a configuration preset (development, production, or testing). Changes multiple settings atomically.
Parameters
preset_name: string- Preset name: 'development', 'production', or 'testing'
config_get desktop destructive
Get a specific configuration value using dot notation (e.g., 'polling.task_interval_seconds').
Parameters
key: string- Configuration key in dot notation (e.g., 'polling.task_interval_seconds', 'logging.level')
config_list desktop destructive
List all desktop agent configuration settings with metadata (file path, last modified, size).
config_list_presets desktop destructive
List available configuration presets with their settings.
config_remove_safe_dir desktop confirm destructive
Remove a directory from the safe directories list. Critical directories (Desktop, Documents, Downloads) are protected.
Parameters
path: string- Directory path to remove
force: boolean (optional)- Force removal of critical directories (use with caution) — default:
false
config_reset desktop confirm destructive
Reset configuration to defaults from settings.example.json. Creates a timestamped backup before resetting.
config_set desktop confirm destructive
Set a configuration value. Validates type and range constraints before saving.
Parameters
key: string- Configuration key in dot notation (e.g., 'polling.task_interval_seconds')
value- New value to set (type must match expected type for key)
validate: boolean (optional)- Whether to validate the value against constraints — default:
true
config_validate desktop destructive
Validate the current configuration. Checks paths exist, values are in range, required keys present, and URL formats.
discover_claude_projects desktop read-only
Discover all Claude Code projects on the user's machine. Scans ~/.claude/projects/ for project directories.
edit_block desktop confirm destructive
Surgically edit a file by replacing a text block. Uses fuzzy matching to find old_text and replace with new_text.
Parameters
path: string- File path to edit
old_text: string- Text block to find and replace
new_text: string- Replacement text block
fuzzy: boolean (optional)- Enable fuzzy matching for old_text — default:
true
execute_bash desktop confirm destructive
Execute a bash command on user's Linux desktop/server. Captures stdout, stderr, and exit code.
Parameters
command: string- Bash command to execute
timeout: integer (optional)- Command timeout in seconds — default:
30 cwd: string (optional)- Working directory for the command
execute_bash_async desktop confirm destructive
Execute a bash command asynchronously on user's Linux desktop/server. Returns a job_id immediately for long-running commands.
Parameters
command: string- Bash command to execute
timeout: integer (optional)- Command timeout in seconds — default:
300 cwd: string (optional)- Working directory for the command
execute_cli_agent desktop destructive
Execute a headless Claude Code CLI agent on user's desktop. Runs Claude CLI with specified persona and task.
Parameters
system_prompt_b64: string- Base64-encoded system prompt for the CLI agent
task: string- The task/prompt for the agent to execute
max_turns: integer (optional)- Maximum conversation turns — default:
10 max_budget_usd: number (optional)- Maximum cost in USD — default:
1 timeout: integer (optional)- Execution timeout in seconds — default:
300 working_directory: string (optional)- Working directory for the CLI agent
execute_powershell desktop confirm destructive
Execute a PowerShell command on user's desktop. Whitelisted cmdlets only. Captures stdout/stderr.
Parameters
command: string- PowerShell command to execute
timeout: integer (optional)- Command timeout in seconds — default:
30
execute_powershell_async desktop confirm destructive
Execute a PowerShell command asynchronously on user's desktop. Always returns a job_id immediately for long-running commands.
Parameters
command: string- PowerShell command to execute
timeout: integer (optional)- Command timeout in seconds — default:
300
get_job_status desktop destructive
Get status of an async PowerShell job. Use this after execute_powershell returns a job_id to check if the job completed and get results.
Parameters
job_id: string- Job ID returned from async execute_powershell (e.g., 'job_abc123def456')
health_check_repo desktop read-only
Check if a repository path is valid and accessible from the desktop agent. Returns git status, file count, and Claude project association.
Parameters
repo_path: string- Repository path to check (e.g., C:\a7)
ingest_claude_ai_export desktop destructive
Ingest a Claude.ai data export (conversations, projects) into the session database. Accepts exported JSON data.
Parameters
export_path: string (optional)- Path to the Claude.ai export file or directory
export_data: object (optional)- Raw export data as JSON object (alternative to export_path)
ingest_claude_sessions desktop read-only
Incrementally ingest Claude Code sessions. Compares file mtimes against known_mtime_map to only parse changed sessions. Returns full session data for syncing to the cloud.
Parameters
repo_path: string (optional)- Repository path to derive project hash
known_session_ids: array (optional)- Session IDs already known to the server (for incremental sync)
known_mtime_map: object (optional)- Map of session_id → file_mtime for change detection
list_claude_projects desktop read-only
List Claude Code projects with metadata (session count, latest activity, project hash). Provides a summary overview of all projects.
list_directory desktop destructive
List files and directories on user's desktop. Supports recursive listing with depth limit.
Parameters
path: string- Directory path to list (e.g., C:\project)
recursive: boolean (optional)- Include subdirectories recursively — default:
false max_depth: integer (optional)- Maximum recursion depth (1-10) — default:
3
list_jobs desktop destructive
List all async PowerShell jobs. Shows job IDs, status, and progress for active and optionally completed jobs.
Parameters
include_completed: boolean (optional)- Include completed/failed jobs in the list — default:
false
parse_claude_session desktop read-only
Parse a single Claude Code session JSONL file. Returns full session data including messages, tool usage, cost estimate, and timestamps.
Parameters
session_path: string- Absolute path to the session .jsonl file
read_file desktop destructive
Read contents of a file from user's desktop. Supports text files with various encodings.
Parameters
path: string- Absolute file path (e.g., C:\project\config.json)
encoding: string (optional)- File encoding (utf-8, ascii, latin-1, etc.) — default:
"utf-8"
resolve_repo_path desktop read-only
Resolve a repository path to its canonical form and derive the Claude project hash. Handles Windows, WSL, and Unix path formats.
Parameters
repo_path: string- Repository path to resolve (e.g., C:\a7, /opt/a7)
scan_claude_sessions desktop read-only
Scan Claude Code sessions for a specific project. Returns session metadata (ID, timestamps, cost, turns) without full content.
Parameters
repo_path: string (optional)- Repository path to derive project hash (e.g., C:\a7 or /opt/a7)
project_path: string (optional)- Direct path to project directory under ~/.claude/projects/
search_claude_sessions desktop read-only
Search Claude Code sessions by keyword. Searches session summaries and optionally message content. Returns matching sessions ranked by relevance.
Parameters
query: string- Search query string
project_hash: string (optional)- Limit search to specific project hash
repo_path: string (optional)- Repository path to derive project hash for filtering
search_content: boolean (optional)- Search within message content (slower but more thorough) — default:
false max_results: integer (optional)- Maximum number of results to return — default:
20
search_code desktop destructive
Search for patterns in code files on user's desktop. Uses regex matching with context lines.
Parameters
path: string- Directory or file path to search
pattern: string- Regex pattern to search for
file_extensions: array (optional)- File extensions to search (e.g., ['.py', '.js']). Empty = all files.
context_lines: integer (optional)- Number of context lines before/after match — default:
2
write_file desktop confirm destructive
Write content to a file on user's desktop. Creates parent directories if needed. Backs up existing files.
Parameters
path: string- Absolute file path (e.g., C:\project\output.txt)
content: string- File content to write
encoding: string (optional)- File encoding (utf-8, ascii, latin-1, etc.) — default:
"utf-8"