WSL Tools

Overview

Seamless file synchronization and path conversion between WSL and Windows, unified into 1 tool.

Tools

wsl

Copy files between WSL and Windows, sync workspace, or check status. Auto-sync (write/edit-time automatic syncing) is configured via the MCP_WSL_AUTOSYNC environment variable, not as wsl actions. The wsl tool itself exposes only the sync and status actions.

Modes:

Single file/directory copy (wsl_path / windows_path)

Direction is auto-detected from the path format:

• Path starts with / → WSL-to-Windows
• Path starts with drive letter (e.g., C:\) → Windows-to-WSL

// WSL to Windows (auto-detected from /home/... or /mnt/... path)
wsl({ wsl_path: "/home/user/project/main.go" })

// Windows to WSL (auto-detected from C:\ path)
wsl({ windows_path: "C:\\Users\\user\\file.txt" })

// With explicit destination
wsl({ wsl_path: "/home/user/file.go", windows_path: "C:\\project\\file.go" })

Workspace sync (direction)

// Sync entire workspace WSL → Windows
wsl({ direction: "wsl_to_windows" })

// Sync with file filter
wsl({ direction: "windows_to_wsl", filter_pattern: "*.go" })

// Preview sync without executing
wsl({ direction: "bidirectional", dry_run: true })

All parameters:

• action (optional): "sync" (default) or "status"
• wsl_path (optional): Source WSL path
• windows_path (optional): Source/destination Windows path
• direction (optional): wsl_to_windows, windows_to_wsl, bidirectional
• filter_pattern (optional): File filter (e.g., *.go)
• dry_run (optional): Preview without executing (default: false)
• create_dirs (optional): Create destination directories (default: true)

Show status (action: “status”)

wsl({ action: "status" })
// Returns: environment detection, path mappings, file locations, auto-sync state

Auto-sync is no longer wsl({enabled: true, ...})

In v3, wsl({enabled: true}) configured auto-sync. In v4, auto-sync is driven by the MCP_WSL_AUTOSYNC env var (and the enabled / sync_on_write / sync_on_edit / silent params are kept in the validator for backward compatibility but are not dispatched as actions).

---

Migration from v3

v3 Tool	v4 Equivalent
wsl_to_windows_copy	wsl({ wsl_path: "/wsl/path" })
windows_to_wsl_copy	wsl({ windows_path: "C:\\..." })
sync_claude_workspace	wsl({ direction: "..." })
wsl_windows_status	wsl({ action: "status" })
configure_autosync	MCP_WSL_AUTOSYNC env var (one-shot config)
get_autosync_config	wsl({ action: "status" })
wsl_sync (v3.x)	wsl({ wsl_path: "..." })
wsl_status (v3.x)	wsl({ action: "status" })

See WSL Integration for complete guide.