claude-code - 💡(How to fix) Fix [BUG] `claude agents` view: severe background color bleed in Apple Terminal.app on macOS (v2.1.139, dark-ansi theme)

Preflight Checklist

• I have searched existing issues and this hasn't been reported yet
• This is a single bug report (please file separate reports for different bugs)
• I am using the latest version of Claude Code

What's Wrong?

In the new claude agents view (added in v2.1.139 as a Research Preview, released 2026-05-11), background ANSI colors persist across cells where they shouldn't, producing large solid red/teal/yellow blocks overlaid on the agent list. Text content is rendered correctly — the bug is purely in background fill / improper reset between cells. The artifacting pattern is consistent with the chalk background-reset issue described in #1341, but on a brand-new surface (agent roster, status indicators, per-row metadata).

The notable environmental observation is that the bug reproduces under the most conservative macOS terminal configuration available:

• Apple Terminal.app (no truecolor support, only 256-color)
• COLORTERM unset (no truecolor capability advertised)
• Theme explicitly set to dark-ansi (user has opted into ANSI-only colors)

This combination suggests the renderer is emitting color escape sequences that don't respect the declared terminal capabilities / theme.

Screenshot attached:

What Should Happen?

The claude agents view should render with clean status indicators and per-row metadata, with proper ANSI reset sequences (\x1b[0m) terminating every background-colored span so colors stay confined to their intended cells.

Given that this environment explicitly signals an ANSI-only color budget:

• theme=dark-ansi is set in settings.json (user has opted into ANSI-only colors)
• COLORTERM is unset (no truecolor capability advertised)
• TERM_PROGRAM=Apple_Terminal (does not support truecolor)

the renderer should respect those constraints and emit only ANSI-safe color escapes that terminate cleanly at cell boundaries — preventing the large solid-color blocks shown in the screenshot.

Error Messages/Logs

N/A — bug is purely visual rendering in the TUI. No errors emitted to stdout/stderr; no entries in session logs; `claude agents` returns to the prompt cleanly when exited.

Steps to Reproduce

1. On macOS (15.7.1, Apple Silicon) in Apple Terminal.app (not iTerm2, Ghostty, etc.), with theme=dark-ansi set in ~/.claude/settings.json.
2. Launch Claude Code agent session: claude agent. Start any task, though ones which produces tool calls and diff output glitch more (e.g. ask it to make a small edit and run tests).
3. Enter to the agent view, observe color bleed across rows.

The bug reproduces consistently. Screenshot in "What's Wrong?" shows the typical artifacting: large solid red, teal, and yellow rectangles overlaying the agent list, with text rendering correctly underneath.

Claude Model

Opus

Is this a regression?

No, this never worked

Last Working Version

N/A (2.1.139 is first release)

Claude Code Version

2.1.139

Platform

Anthropic API

Operating System

macOS

Terminal/Shell

Terminal.app (macOS)

Additional Information

No response