Secondary/instructional text unreadable on dark terminal backgrounds (theme picker affected)

Open 💬 0 comments Opened Jul 13, 2026 by rexebin

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

  1. Use a dark terminal theme with a very dark background (in my case macOS Terminal.app with the "Night Owl" theme, background #011627).
  2. Run /theme to open the theme picker.
  3. 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.
  4. 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.

View original on GitHub ↗