mcp-windows/CHANGELOG.md

# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [3.0.0] - 2026-05-25

### Added

#### v3.0 -- WSL & Package Management (6 tools)
- `windows_wsl_list` -- List WSL distributions with status and version
- `windows_wsl_manage` -- Start, stop, shutdown, export, import, remove WSL distros
- `windows_wsl_exec` -- Execute commands inside a WSL distribution
- `windows_winget_search` -- Search winget package repository
- `windows_winget_manage` -- Install, upgrade, uninstall, list packages via winget
- `windows_winget_export` -- Export/import winget package lists

#### v3.1 -- Storage & System Management (6 tools)
- `windows_disk_cleanup` -- Analyze and clean disk space (temp, cache, logs)
- `windows_symlink` -- Create and manage symlinks, junctions, hard links
- `windows_timezone` -- Get/set timezone, list timezones, sync time
- `windows_features` -- Enable/disable Windows optional features
- `windows_smb_shares` -- List local shares, map/unmap network drives
- `windows_dns_cache` -- View, clear DNS cache, resolve domains

#### v3.2 -- Automation & Advanced (5 tools)
- `windows_shortcut` -- Create and read .lnk shortcut files
- `windows_input` -- Simulate keyboard/mouse (keys, combos, text, clicks, moves)
- `windows_font_list` -- List installed fonts from registry
- `windows_sandbox` -- Check/launch Windows Sandbox with custom config
- `windows_screen_capture` -- Screen recording via ffmpeg (start/stop/status)

### Changed
- Version bumped to 3.0.0 (80 tools total)

## [2.0.0] - 2026-05-25

### Added

#### v2.0 -- Connectivity & Hardware (7 tools)
- `windows_bluetooth_get` -- Bluetooth adapter status and paired devices
- `windows_bluetooth_control` -- Enable/disable Bluetooth, disconnect devices
- `windows_wifi_networks` -- Scan Wi-Fi networks, list saved profiles
- `windows_wifi_connect` -- Connect, disconnect, forget Wi-Fi networks
- `windows_usb_devices` -- List USB devices with safe eject
- `windows_printer_list` -- List printers, queue, set default, clear queue
- `windows_hosts_file` -- Read/manage Windows hosts file

#### v2.1 -- Appearance & Desktop (5 tools)
- `windows_theme_get` -- Dark mode, accent color, wallpaper, taskbar
- `windows_theme_set` -- Set dark mode, wallpaper, transparency, taskbar
- `windows_virtual_desktop` -- List, create, switch, remove virtual desktops
- `windows_focus_mode` -- Get/set Focus Assist / Do Not Disturb
- `windows_default_apps` -- Get default file associations

#### v2.2 -- Security & Maintenance (7 tools)
- `windows_firewall_get` -- Firewall status and rules
- `windows_firewall_manage` -- Create, enable, disable, delete firewall rules
- `windows_updates` -- Windows Update status and history
- `windows_event_log` -- Read event log entries with filters
- `windows_restore_point` -- List/create System Restore points
- `windows_certificate_list` -- List certificates in certificate store
- `windows_performance_monitor` -- Real-time CPU, RAM, disk, network stats

## [1.0.0] - 2026-05-25

### Added

#### v1.0 — Core (14 tools)
- `windows_execute` — Execute shell commands (PowerShell, cmd, bash) with timeout and background support
- `windows_process_list` — List running processes with PID, CPU, memory, window title
- `windows_audio_get` — Get master volume, mute state, and default audio device
- `windows_audio_set` — Set volume (0-100), mute/unmute/toggle
- `windows_system_info` — Comprehensive system info (OS, CPU, RAM, disk, network, uptime)
- `windows_terminal_start` — Start persistent interactive terminal sessions (pwsh, cmd, bash, python, node, wsl)
- `windows_terminal_send` — Send input to a running terminal session
- `windows_terminal_read` — Read output with line pagination (supports negative offset for tail)
- `windows_terminal_list` — List all active terminal sessions
- `windows_terminal_kill` — Terminate a terminal session by PID
- `windows_file_read` — Read files with line pagination, image base64, binary detection
- `windows_file_write` — Write/append to files, auto-create parent directories
- `windows_file_edit` — Surgical find/replace with near-match suggestions
- `windows_search` — Search files by name (glob) or content (regex), uses ripgrep when available

#### v1.1 — System Control (9 tools)
- `windows_process_kill` — Terminate processes by PID or name with force option
- `windows_service_list` — List Windows services with status, startup type, description
- `windows_service_control` — Start, stop, restart, enable, disable services
- `windows_audio_app_volumes` — List per-application audio sessions
- `windows_power_get` — Battery level, power plan, screen/sleep timeouts
- `windows_power_action` — Sleep, hibernate, lock, shutdown, restart, switch power plan
- `windows_network_info` — Adapters, IPs, DNS, gateway, Wi-Fi SSID/signal, connectivity
- `windows_drives` — List drives with type, label, capacity, free space, usage bar
- `windows_file_search` — Search files by name or content using PowerShell

#### v1.2 — Desktop Automation (8 tools)
- `windows_display_get` — Resolution, refresh rate, scaling, multi-monitor layout
- `windows_display_set` — Change resolution, brightness
- `windows_screenshot` — Capture screen, window, or region as base64 PNG or file
- `windows_window_list` — List visible windows with title, PID, position, size, state, z-order
- `windows_window_control` — Minimize, maximize, restore, close, focus, move, resize, topmost
- `windows_clipboard_get` — Read clipboard (text, files, image as base64)
- `windows_clipboard_set` — Set clipboard text, file list, or clear
- `windows_notification_send` — Send Windows toast notifications

#### v1.3 — Admin Tools (9 tools)
- `windows_task_scheduler_list` — List scheduled tasks with status, last/next run, triggers
- `windows_task_scheduler_manage` — Create, delete, enable, disable, run scheduled tasks
- `windows_registry_read` — Read registry keys, values, subkeys (HKLM/HKCU/HKCR)
- `windows_registry_write` — Write registry values with HKLM safety gate
- `windows_env_get` — Get environment variables with PATH parsing (user/system scope)
- `windows_env_set` — Set/remove env vars, append/prepend to PATH persistently
- `windows_startup_list` — List startup items from registry, startup folder, and task scheduler
- `windows_startup_manage` — Add, remove, enable, disable startup items
- `windows_mcp_config` — Get/set MCP configuration (blocked commands, allowed dirs, limits)

#### v1.4 — Advanced (4 tools)
- `windows_installed_apps` — List installed applications from registry and Store
- `windows_dialog` — Show message boxes, input prompts, file/folder pickers
- `windows_network_connections` — Active TCP connections (netstat) with process info
- `windows_recycle_bin` — List, restore, empty, or get size of Recycle Bin

### Architecture
- `src/shell.ts` — PowerShell/cmd/bash executor with persistent terminal session manager
- Win32 P/Invoke via inline C# for audio COM, window management, display control
- STA subprocess pattern for clipboard/audio COM threading
- Ring buffer (5000 lines) for terminal session output overflow protection
- MCP SDK `@modelcontextprotocol/sdk` v1.12.1 with stdio transport