claude-code - 💡(How to fix) Fix Ctrl+V image paste should warn when xclip/xsel missing on Linux [1 comments, 2 participants]

On Linux, the input prompt shows a tooltip: "press Ctrl+V to paste images". However, this feature silently fails if xclip (or xsel) is not installed — there's no error message or indication of what's wrong.

• Or when paste fails due to missing clipboard tool, show an actionable error: "Image paste requires xclip. Install with: sudo apt install xclip"

1. Nothing happens — no error, no feedback

TL;DR

Modify the input prompt tooltip to mention the dependency on xclip or display an error message when the paste fails due to the missing clipboard tool.

Guidance

• Update the tooltip to include the dependency information, such as "press Ctrl+V to paste images (requires xclip)".
• Implement a check for the presence of xclip or xsel before attempting to paste an image, and display an actionable error message if the tool is missing.
• Consider adding a fallback or alternative method for pasting images that does not rely on xclip or xsel.
• Verify that the updated tooltip or error message is displayed correctly in different environments, such as gnome-terminal and Kitty.

Example

// Pseudocode example of checking for xclip presence
if (!isXclipInstalled()) {
  showError("Image paste requires xclip. Install with: sudo apt install xclip");
} else {
  // Proceed with image paste
}

Notes

The solution assumes that the presence of xclip or xsel can be reliably detected. If this is not the case, additional error handling may be necessary.

Recommendation

Apply workaround: Modify the input prompt tooltip to mention the dependency on xclip or display an error message when the paste fails due to the missing clipboard tool, as this provides a clear and actionable solution for users.