PowerShell.MCP v1.5.1 - Recursive Search & Performance Improvements

[yotsuda]

Recursive Search & Performance Improvements

This release adds recursive directory search to Show-TextFile and brings significant performance optimizations across file operations.

🎉 What's New

Show-TextFile -Recurse

Search files recursively across subdirectories:

Show-TextFile . -Recurse -Pattern "TODO"           # Search all files
Show-TextFile *.cs -Recurse -Contains "FIXME"      # Search C# files only

Requires -Pattern or -Contains to be specified.

-Contains and -Pattern Combination

-Contains and -Pattern can now be combined (OR condition):

Show-TextFile log.txt -Contains "[Error]" -Pattern "Warning|Critical"
# Matches lines containing "[Error]" OR matching "Warning|Critical"

FileShare.ReadWrite Support

Show-TextFile can now read files locked by other processes (e.g., log files being written to by another application).

Newline Normalization in Update-MatchInFile

Newlines in -Replacement are automatically normalized to match the file's line ending style (CRLF/LF).

---

📊 What's Changed Since v1.5.0

New Features

• -Recurse parameter: Recursive directory search in Show-TextFile
• -Contains + -Pattern: OR condition when both are specified
• FileShare.ReadWrite: Read files locked by other processes
• Newline normalization: Auto-normalize line endings in replacement text

Performance Improvements

• Cached compiled Regex instance across files
• Cached Match results to avoid redundant regex calls
• Fast BOM-only encoding detection for Show-TextFile
• Batch WriteObject calls for better output performance
• Index-based highlighting instead of Regex.Replace

Documentation

• Simplified PlatyPS help documentation for LLM consumption

Code Quality

• Removed UTF-8 BOM from all C# files
• Removed trailing whitespace from C# files

Tests

• Added ShowTextFileContainsPatternCombination.Tests.ps1
• Added ShowTextFileShareReadWrite.Tests.ps1
• Added UpdateMatchNewlineNormalization.Tests.ps1

---

🔄 Installation & Upgrade

Windows

# New installation
Install-Module PowerShell.MCP -Force

# Upgrade existing
Update-Module PowerShell.MCP

Linux / macOS

# Install
pwsh -Command "Install-Module PowerShell.MCP -Scope CurrentUser -Force"

# Set execute permission
chmod +x $(pwsh -Command "Import-Module PowerShell.MCP; Get-MCPProxyPath")

Update MCP Configuration

1. Get new proxy path:

# Windows (escaped for JSON)
Get-MCPProxyPath -Escape

# Linux / macOS
Get-MCPProxyPath

2. Update claude_desktop_config.json with the path from step 1:

{
  "mcpServers": {
    "PowerShell": {
      "command": "C:\\Users\\YourName\\Documents\\PowerShell\\Modules\\PowerShell.MCP\\1.5.1\\bin\\win-x64\\PowerShell.MCP.Proxy.exe"
    }
  }
}

3. Restart Claude Desktop (or Claude Code)

📖 Full Guide: https://github.com/yotsuda/PowerShell.MCP#quick-start

---

Full Documentation: https://github.com/yotsuda/PowerShell.MCP

Questions? GitHub Discussions | Report Issues: GitHub Issues

---

This discussion was created from the release PowerShell.MCP v1.5.1 - Recursive Search & Performance Improvements.