From 47b497310a50cb49f0ef13442999fe2ee7843cff Mon Sep 17 00:00:00 2001
From: "google-labs-jules[bot]"
 <161369871+google-labs-jules[bot]@users.noreply.github.com>
Date: Wed, 22 Jul 2026 22:04:39 +0000
Subject: [PATCH] fix: improve accessibility for navigation hints

---
 .jules/palette.md                               | 3 +++
 src/cli/ui/components/CommandSuggestionList.tsx | 2 +-
 2 files changed, 4 insertions(+), 1 deletion(-)
 create mode 100644 .jules/palette.md

diff --git a/.jules/palette.md b/.jules/palette.md
new file mode 100644
index 00000000..54137737
--- /dev/null
+++ b/.jules/palette.md
@@ -0,0 +1,3 @@
+## 2026-07-22 - Screen Reader Friendly Navigation Hints
+**Learning:** Screen readers in CLI environments (like Ink) rely on raw text output and often fail to announce symbolic characters (e.g., up/down arrows, return symbol) properly, causing accessibility regressions.
+**Action:** Use visually concise but screen-reader-friendly descriptive text (e.g., 'Up/Down', 'Enter') instead of symbols for keyboard navigation hints.
diff --git a/src/cli/ui/components/CommandSuggestionList.tsx b/src/cli/ui/components/CommandSuggestionList.tsx
index 7e66838a..d51fe548 100644
--- a/src/cli/ui/components/CommandSuggestionList.tsx
+++ b/src/cli/ui/components/CommandSuggestionList.tsx
@@ -116,7 +116,7 @@ export const CommandSuggestionList: React.FC<CommandSuggestionListProps> = ({
         </Box>
         <Box>
           <Text color={COLORS.text.muted} dimColor>
-            ↑↓ nav · ⏎ select · esc close
+            Up/Down nav · Enter select · Esc close
           </Text>
         </Box>
       </Box>