docs: fix visual companion launch for Claude Code on Windows#768
Closed
lucasyhzhu-debug wants to merge 1 commit intoobra:mainfrom
Closed
docs: fix visual companion launch for Claude Code on Windows#768lucasyhzhu-debug wants to merge 1 commit intoobra:mainfrom
lucasyhzhu-debug wants to merge 1 commit intoobra:mainfrom
Conversation
…dows The existing Windows section documented the auto-detection (OSTYPE/MSYSTEM) that forces foreground mode, but missed a critical detail: foreground mode blocks the Bash tool call in Claude Code, causing it to hang until timeout. The fix is to set `run_in_background: true` on the Bash tool call so the Claude Code harness (not the shell) manages the process lifecycle. Changes: - Split "Claude Code" section into macOS/Linux and Windows variants - Windows variant documents `run_in_background: true` requirement - Merged the standalone "Windows" section into "Claude Code (Windows)" since the auto-detection handles the foreground switch - Updated "Finding connection info" for the run_in_background pattern Fixes obra#767 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Owner
|
Thanks @lucasyhzhu-debug! This is already covered on the dev branch — commit f34ee47 made the same changes (split Claude Code into macOS/Linux and Windows sections, document |
obra
added a commit
that referenced
this pull request
Mar 17, 2026
vladivis
pushed a commit
to vladivis/superpowers
that referenced
this pull request
Mar 18, 2026
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
2 participants
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.
Summary
run_in_background: trueis required on the Bash tool call for Windows, since the script's auto-detected foreground mode blocks the tool call otherwiserun_in_backgroundpatternContext
The script already auto-detects Windows (via
OSTYPE/MSYSTEM) and forces--foregroundmode — that part works. But foreground mode means the Bash tool call in Claude Code blocks forever (or until timeout), becausenode server.jsnever returns. The missing documentation was: userun_in_background: trueon the Bash tool so the Claude Code harness manages the process lifecycle across turns.Fixes #767
Test plan
🤖 Generated with Claude Code