From 4421d6e6a53cc3ed43a2688abac16f9d46535772 Mon Sep 17 00:00:00 2001
From: VERSE <sunnyone0901@gmail.com>
Date: Fri, 31 Jul 2026 10:55:54 +0700
Subject: [PATCH] docs(readme): warning about potential conflicts

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

diff --git a/README.md b/README.md
index e776f77..b543796 100644
--- a/README.md
+++ b/README.md
@@ -117,6 +117,9 @@ iris uninstall
 
 ## Shell setup
 
+> [!WARNING]
+> **IRIS may cause visual conflicts and keybinding overlaps with other shell autosuggestion plugins or third-party completion tools. To prevent this, please disable them safely (e.g., zsh-autosuggestions, zsh-autocomplete, atuin, flyline, ...)**
+
 Add an alias to your shell configuration file to launch IRIS easily:
 
 **Zsh (`~/.zshrc`):**