Skip to content

refactor: drop the Windows PowerShell launcher in favor of Git Bash#192

Merged
fujibee merged 1 commit into
mainfrom
windows-gitbash-pr186
Jun 22, 2026
Merged

refactor: drop the Windows PowerShell launcher in favor of Git Bash#192
fujibee merged 1 commit into
mainfrom
windows-gitbash-pr186

Conversation

@fujibee

@fujibee fujibee commented Jun 22, 2026

Copy link
Copy Markdown
Owner

Rebases #186 by @lucianlamp onto current main and resolves the conflicts with the 1.1.0 restructure. Commit authorship is preserved (a8b2795, authored by @lucianlamp).

What

Drops the Windows PowerShell launcher in favor of Git Bash:

  • removes scripts/windows/agmsg.ps1, install-agmsg.ps1, the PowerShell smoke test, and tests/test_windows_powershell.bats
  • keeps Windows support on the Bash/Git Bash path: the dispatcher (scripts/windows/), delivery commandWindows wrapping, and legacy helper cleanup
  • updates docs/windows.md, README, and llms.txt to make Git Bash the explicit execution path

Why

PowerShell can't execute bare .sh files, and a bare bash can resolve to the WSL shim (separate $HOME/SQLite DB). Pinning the execution path to Git Bash removes that ambiguity.

Notes

Supersedes #186 — the fork branch couldn't be force-updated cleanly, so this proxy branch carries @lucianlamp's commit unchanged. #186 will be closed with credit once this lands. Full suite green (the 2 failures are the known load-dependent test_watch flake, unrelated).

The PowerShell launcher (scripts/windows/agmsg.ps1 + install-agmsg.ps1) was a
thin shim that located Git Bash and forwarded to the Bash scripts. Codex on
Windows runs commands through PowerShell, so agents can call the scripts
directly via Git Bash (`bash -lc 'scripts/*.sh'`), and delivery hooks are
already wrapped for Git Bash by windows_wrap() in delivery.sh. The separate
PowerShell reimplementation is now redundant.

Removed:
- scripts/windows/agmsg.ps1, scripts/windows/install-agmsg.ps1
- docs/windows.md
- tests/smoke_windows_powershell.ps1, tests/test_windows_powershell.bats
- the PowerShell launcher install step in install.sh
- the README "Native Windows / PowerShell" section (replaced with a Git Bash note)

Kept (general Windows support): the Bash dispatcher (dispatch.sh), the delivery
hook Git Bash wrapping (delivery.sh windows_wrap), the sqlite3 shim, and
install.sh's legacy-helper cleanup.

BREAKING CHANGE: the `agmsg` PowerShell command is no longer installed. On
Windows, call the scripts through Git Bash, e.g.
`bash -lc 'scripts/whoami.sh "$(pwd)" codex'`. If a bare `bash` resolves to the
WSL shim, pin Git Bash in your PowerShell profile:
Set-Alias bash 'C:\Program Files\Git\bin\bash.exe'.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01XpJ8VvSV1hNdJWy875V5tm
@fujibee fujibee merged commit 3f9fdc4 into main Jun 22, 2026
8 of 11 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants