Remote Image Paste
Paste images from a local Linux clipboard into a POSIX VS Code remote terminal. Pi Code TUI is not
required.
Behavior
With a remote terminal focused, press Ctrl+V:
- The extension reads an image using local
wl-paste or xclip.
- It writes the image to
/tmp/remote-terminal-image-<uuid>.<ext> on the remote.
- It inserts that path into the active terminal without submitting it.
If the clipboard does not contain a supported image, VS Code performs its normal terminal text
paste. The extension does not inspect or require the terminal's foreground process.
VS Code sends terminal shortcuts to the shell unless their command is listed in
terminal.integrated.commandsToSkipShell. The extension contributes
remote-image-paste.paste by default but never rewrites user settings. An explicit
-remote-image-paste.paste entry opts out and suppresses configuration warnings.
Otherwise, the extension warns when an effective setting omits the command or enables
terminal.integrated.sendKeybindingsToShell, which overrides the command list.
Requirements
- Local Linux VS Code desktop
- VS Code 1.130 or newer
- A VS Code remote with a POSIX terminal and writable
/tmp
wl-paste from wl-clipboard, or xclip, installed on the local desktop
Supported clipboard image types: PNG, JPEG, WebP, and GIF.
Remote support status
Dev Containers are verified. Support for other POSIX VS Code remotes is implemented but has not yet
been tested.
Development
From this directory:
pnpm install
pnpm check
pnpm package
