Skip to content

docs: make tmux permission diagnostics reproducible - #12350

Closed
austinywang wants to merge 1 commit into
mainfrom
followup/pr-12219
Closed

austinywang wants to merge 1 commit into
mainfrom
followup/pr-12219

Conversation

@austinywang

@austinywang austinywang commented Sep 11, 2026 •

Copy link
Copy Markdown
Contributor

Follow-up to #12219, incorporating and crediting @haung921209. Improves diagnostics by comparing exact operations across shell contexts and documenting server inspection.\n\nValidation: git diff --check; Linux shell and isolated tmux checks; python3 scripts/swift_file_length_budget.py. Builds were not run per Linux-only constraints. Localization audit: Markdown only; no catalogs changed.


View with [code]smith Autofix with [code]smith
Need help on this PR? Tag @codesmith-bot with what you need. Autofix is disabled.


Note

Low Risk
Markdown-only documentation with no runtime, API, or security behavior changes.

Overview
Adds a Diagnosing protected-folder access errors section to docs/local-tmux.md for macOS-style Operation not permitted failures in tmux (e.g. under ~/Documents).

The guide tells users to capture evidence before restarting cmux or tmux, inspect the running server (tmux display-message, ps, lsof), query the correct socket (-S, cmux local-tmux list --json), and compare the same absolute-path operations across tmux, cmux, and another terminal using copy-paste POSIX snippets for directory listing and file read. It also lists what to include in bug reports, distinguishes EPERM from EACCES, and links Apple guidance and issue #2866 as an investigation reference—not a single root cause.

Reviewed by Cursor Bugbot for commit 0002c27. Bugbot is set up for automated code reviews on this repo. Configure here.


Summary by cubic

Adds a documented procedure for diagnosing Operation not permitted errors in tmux panes, so failures are recorded before any restart or permission change. The new section covers identifying the server, comparing the exact failing command across shell contexts, and reporting the right data without including private contents.

Written for commit 0002c27. Summary will update on new commits.

Review in cubic

@vercel

vercel Bot commented Sep 11, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
cmux166 Ready Ready Preview Sep 11, 2026 10:49pm UTC
cmux41 Ready Ready Preview Sep 11, 2026 10:49pm UTC

@coderabbitai

coderabbitai Bot commented Sep 11, 2026

Copy link
Copy Markdown

Warning

Review limit reached

Next included review available in 4 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used all 10 included reviews currently available.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Advanced

Run ID: 43963a49-97e6-4506-82fc-c2a15bc18ffb

📥 Commits

Reviewing files that changed from the base of the PR and between c006e64 and 0002c27.

📒 Files selected for processing (1)
  • docs/local-tmux.md

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@github-actions

Copy link
Copy Markdown
Contributor

All contributors have signed the CLA ✍️ ✅
Posted by the CLA Assistant Lite bot.

@teamleaderleo

Copy link
Copy Markdown
Collaborator

Landed in #12219 (d630cb8), closing.

This branch was successfully deployed

2 active deployments
Preview – cmux166 — 0002c27e Deployed Sep 11, 2026 by vercel[bot]
Preview – cmux41 — 0002c27e Deployed Sep 11, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area: docs README, docs pages, the site, contributor guides ready-to-land Reviewed and ready to land when CI is green

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants