From da39f6f1a8554ffe9bb6aee6cb7a317dc7ae3296 Mon Sep 17 00:00:00 2001
From: Andrey Nering <andreynering@users.noreply.github.com>
Date: Fri, 27 Mar 2026 15:09:24 -0300
Subject: [PATCH] docs(readme): add q&a section and note about clipboard
 support (#2509)

---
 README.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/README.md b/README.md
index 183104803429ed200aeca2ac89cac76178d741f2..9b4f8e49218ba2982d04e56b22a4bd480bc110d9 100644
--- a/README.md
+++ b/README.md
@@ -784,6 +784,19 @@ Or by setting the following in your config:
 Crush also respects the `DO_NOT_TRACK` convention which can be enabled via
 `export DO_NOT_TRACK=1`.
 
+## Q&A
+
+### Why is clipboard copy and paste not working?
+
+Installing an extra tool might be needed on Unix-like environments.
+
+| Environment         | Tool                     |
+| ------------------- | ------------------------ |
+| Windows             | Native support           |
+| macOS               | Native support           |
+| Linux/BSD + Wayland | `wl-copy` and `wl-paste` |
+| Linux/BSD + X11     | `xclip` or `xsel`        |
+
 ## Contributing
 
 See the [contributing guide](https://github.com/charmbracelet/crush?tab=contributing-ov-file#contributing).