docs: explain MacBook lid sleep in troubleshooting - #25
Open
matyasrathonyi wants to merge 1 commit into
Open
Conversation
matyasrathonyi
marked this pull request as ready for review
September 5, 2026 10:21
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
1 participant
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.
Happy users can connect from a phone while the agent still runs on their MacBook. This adds a troubleshooting entry explaining why closing the lid can pause local execution, how to distinguish sleep from permission or connection problems, and the available approaches.
Disclosure: I make Clamshell. The entry links to our published Apple Silicon setup guide and explicitly identifies Clamshell as an optional paid app with a trial. It also includes external-display and lid-open alternatives. The link can be removed if you prefer to keep the FAQ vendor-neutral.
Validation: this changes only content/docs/faq.mdx; the patch was checked against the current upstream file. The linked guide is live, passed website route/CSP checks, and was visually checked at desktop and phone widths. A physical phone-to-Mac closed-lid run was not performed for this contribution.