docs: add Git Bash on Windows section to installing guide#635
Merged
swissspidy merged 7 commits intomainfrom Apr 14, 2026
Merged
docs: add Git Bash on Windows section to installing guide#635swissspidy merged 7 commits intomainfrom
swissspidy merged 7 commits intomainfrom
Conversation
Agent-Logs-Url: https://github.com/wp-cli/handbook/sessions/dd455d4f-9431-4eb1-ba86-838e994cfe8f Co-authored-by: swissspidy <841956+swissspidy@users.noreply.github.com>
Copilot
AI
changed the title
[WIP] Add usage details for wp-cli on Windows using Git Bash
docs: add Git Bash on Windows section to installing guide
Apr 14, 2026
Member
|
/gemini review |
Contributor
There was a problem hiding this comment.
Code Review
This pull request adds a guide and a shell script wrapper for running WP-CLI within Git Bash on Windows. The review feedback identifies several technical improvements for the script, including switching the shebang to bash to support specific syntax, enhancing path detection for MSYS2 environments, and fixing a logic error in how directory paths with spaces are handled.
Contributor
There was a problem hiding this comment.
Pull request overview
Adds Git Bash-specific guidance to the Windows installation docs so users can run WP-CLI from Git Bash by creating a POSIX-style wp wrapper script alongside wp-cli.phar.
Changes:
- Added a new “Using WP-CLI with Git Bash on Windows” subsection under “Installing on Windows”.
- Documented a
wp(no-extension) shell wrapper script intended to runwp-cli.pharfrom Git Bash, including optional Cygwin path translation logic.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Agent-Logs-Url: https://github.com/wp-cli/handbook/sessions/95978eb1-7a0d-4e19-8163-cddb00121451 Co-authored-by: swissspidy <841956+swissspidy@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
WP-CLI's
wp.batwrapper doesn't work in Git Bash on Windows, leaving users without a clear path forward. This adds a dedicated subsection under "Installing on Windows" explaining how to create a POSIX-compatiblewpwrapper file (no extension) that works in Git Bash, including Cygwin path translation logic.Changes
guides/installing.md— added#### Using WP-CLI with Git Bash on Windowssubsection after the existing Windows CLI instructions, with the following wrapper script to place atc:\wp-cli\wp: