Skip to content

fix(windows): add PowerShell continuation fallback and docs#2

Open
advancegabrielguihurt wants to merge 2 commits into
hexsprite:masterfrom
advancegabrielguihurt:feat/windows-support
Open

fix(windows): add PowerShell continuation fallback and docs#2
advancegabrielguihurt wants to merge 2 commits into
hexsprite:masterfrom
advancegabrielguihurt:feat/windows-support

Conversation

@advancegabrielguihurt
Copy link
Copy Markdown

Summary

Windows had the same failure mode as Linux: the original stop hook depended on macOS osascript after 5 iterations.

This PR includes the loop_limit: null fix from #1 (required on Windows too) and adds Windows-specific support:

  • hooks/continue-windows.ps1 — optional PowerShell SendKeys fallback for legacy configs that cannot set loop_limit: null
  • Windows install docs — Git Bash requirement, jq install, hook path conventions, known Hooks Execution Log quirk

Merge order

Merge #1 first, then this PR (or rebase onto master after #1 lands). This branch contains the Linux commit plus the Windows commit.

Test plan

  • Install hook via Git Bash with loop_limit: null in .cursor/hooks.json
  • Ensure jq is available in Git Bash
  • Run /ralph-loop with --max-iterations 8 and confirm iterations continue past 5
  • (Optional) Test continue-windows.ps1 only if validating legacy fallback without loop_limit: null

Made with Cursor

Guihurt and others added 2 commits May 26, 2026 03:59
Cursor caps followup_message chains at 5 unless loop_limit is null.
The previous macOS-only osascript workaround silently failed on Linux
at iteration 5, stopping the loop.

- Add hooks/hooks.json.example with loop_limit: null
- Simplify stop hook to always emit followup_message
- Add optional continue-linux.sh keyboard fallback for legacy configs
- Document Linux requirements in README and ralph command

Co-authored-by: Cursor <cursoragent@cursor.com>
Windows installs failed for the same reason as Linux: the stop hook
relied on macOS osascript after 5 iterations. The loop_limit: null
fix (included from the Linux PR) is the primary path.

This commit adds continue-windows.ps1 for legacy configs that cannot
set loop_limit, plus Windows hook path and Git Bash requirements.

Co-authored-by: Cursor <cursoragent@cursor.com>
@Guihurt
Copy link
Copy Markdown

Guihurt commented May 26, 2026

I'm really sorry about this, I know this can become really annoying.

I asked Composer to make some fixes for Windows and Linux, and it assumed my mention of different PR's meant I wanted them created and pushed. 2.5 is so fast by the time I thought I should fork the repo first to test the changes locally, I looked up and saw it was creating the PR's already.

Please feel free to close both this and the related PR.

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