Secondary/instructional text unreadable on dark terminal backgrounds (theme picker affected)
Description
Secondary/instructional text rendered by Claude Code's own UI (not the user's shell prompt) appears in a near-black, low-contrast color that is nearly invisible against a dark terminal background.
Reproduction
- Use a dark terminal theme with a very dark background (in my case macOS Terminal.app with the "Night Owl" theme, background
#011627). - Run
/themeto open the theme picker. - The picker's own instructional text —
"Choose the text style that looks best with your terminal"— renders in near-black text, essentially invisible against the dark background. - This happens regardless of which theme is currently active. I explicitly selected "Dark mode" (not "Auto") to rule out the OSC 11 background-detection issue used by "Auto" — the low-contrast text persisted.
Expected
Secondary/instructional UI text should use a color with sufficient contrast against dark backgrounds, consistent with the selected theme (Dark mode, Dark mode colorblind-friendly, etc.), the same way primary text does.
Actual
The text renders in a fixed, very dark color independent of the selected theme, making it unreadable on dark terminal backgrounds.
Environment
- Terminal: macOS Terminal.app
- Terminal theme: Night Owl (background
#011627) - Claude Code theme setting: Dark mode (explicitly selected, not Auto)
- Claude Code version: v2.1.207
Related issues
This looks like the same underlying class of bug as:
- #47809 — Error text color too dark on dark terminal backgrounds
- #33177 — Diff context text color too dark on dark terminal themes
- #24756 — Black text unreadable in dark mode terminal when using AskUserQuestion
In this case it affects the theme picker's own instructional text, suggesting certain "secondary" text styles are hardcoded to a fixed dark color rather than drawn from the active theme's palette.