docs: add clipboard and file bridge plan - #7
Open
iagodahlem wants to merge 1 commit into
Open
Conversation
Documents why copy from the Linux box to the Mac fails today, why images and files can never travel over the clipboard escape sequence, and the two fixes: an OSC 52 text path through tmux, and an ssh file bridge for images and video.
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.
Copying from the Linux box to the Mac has never worked, and images or files cannot be pasted the other way at all. This documents why, and the plan to fix both, before any config changes land.
No behavior changes here. This is the plan only, so the shell functions and tmux settings it describes are not applied yet.
Changes:
Clipboard plan doc: new
CLIPBOARD.mdcovering both directions across plain ssh, tmux, and an agent CLI, so the next pass can be applied without re-deriving any of it.Root cause for text: the copy-mode binding pipes to
xclip, which is not installed on the headless box and never will be, so every copy silently goes nowhere.Root cause for images: OSC 52 carries text only, so images and video can never travel over the clipboard path regardless of configuration, and need a file transfer instead.
Text fix: switch tmux to
set-clipboard onand let it emit OSC 52 itself, plus acopyfunction that prefers the tmux route because that is the only one available to an agent CLI's shell tool.File fix: an ssh pull from the Mac, so a screenshot or a dragged file lands on the Linux box as a path, and works from inside an agent session with no extra window.
Audit findings: records the current tmux settings, the missing
xterm-ghosttyterminfo, and the ssh key that was generated but never authorized, since those are the actual blockers.