✅ Implementation Complete: --ssh-args Global Argument

Successfully implemented the global --ssh-args argument for WP-CLI, addressing issue #5100.

Implementation Checklist

• Add ssh-args to global config specification in php/config-spec.php
• Add ssh-args to alias specification in php/WP_CLI/Configurator.php
• Add ssh-args to GlobalConfig type in php/class-wp-cli.php for PHPStan
• Modify generate_ssh_command() in php/WP_CLI/Runner.php to append ssh-args to:
  • SSH command
  • Docker command
  • Docker Compose command
  • Docker Compose Run command
  • Vagrant command
• Filter --ssh and --ssh-args from arguments passed to remote WP-CLI (improved regex)
• Add Behat test for SSH scheme with --ssh-args
• Add Behat test for multiple SSH args
• Add Behat test for Docker scheme with --ssh-args
• Run linting (passed ✅)
• Run code style check (passed ✅)
• Run static analysis (passed ✅)
• Manual testing (passed ✅)
• Address code review feedback
• Security validation (proper escaping ✅)

Recent Changes

Improved SSH flag filtering regex (latest commit):

• Added start anchor (^) to prevent false positives
• Changed to match both = separator and end-of-string for space-separated flags
• Now correctly filters: --ssh, --ssh=value, --ssh-args, --ssh-args=value

Changes Summary

5 files modified (+47 lines, -7 lines)

Usage Examples

# SSH timeout option
wp --ssh=server --ssh-args="-o ConnectTimeout=5" core version

# Multiple SSH options
wp --ssh=server --ssh-args="-o ConnectTimeout=5" --ssh-args="-o ServerAliveInterval=10" core version

# Docker environment variable
wp --ssh=docker:wordpress --ssh-args="--env MY_VAR=value" core version

Key Features

✨ Multiple arguments supported via repeated --ssh-args flags
✨ Works with all schemes: SSH, Docker, Docker Compose, Vagrant
✨ Proper shell escaping for security
✨ Arguments filtered from remote command (both = and space-separated)
✨ Can be used in aliases
✨ Fully backward compatible

Ready for review and merge!

• Fixes Add global --ssh-args argument ideas#123

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.