Feature request: toggle to suppress the tmux focus-events-off notice (or fix the focus-out re-render that forces it off)

Open 💬 2 comments Opened Jun 28, 2026 by PearGod

What I'm asking for

A way to suppress the notice Claude Code surfaces when tmux focus-events
is off
— ideally a settings.json flag or env var. And/or a fix to the
underlying focus-out re-render behavior (below) that would let me turn
focus-events back on without the side effect that made me disable it.

Why I have focus-events off in the first place

This is the part I want to surface, because the real fix might be on your
end rather than a suppress toggle.

I deliberately set set -g focus-events off in my tmux config. With
focus-events on, Claude Code's Ink TUI re-renders on every focus-out,
writing to stdout. That stdout registers as pane activity, which causes:

  • a false "warm"/busy reading on backgrounded, genuinely idle sessions

(I drive busy/idle detection off pane activity across many tmux sessions), and

  • a false iTerm2 tab-activity dot on idle panes.

This looks like the render-only behavior tracked in
https://github.com/anthropics/claude-code/issues/30199. Turning
focus-events off is my workaround for that cosmetic noise.

The conflict

Because focus-events is off, Claude Code now surfaces a notice asking for
it to be on. So I'm stuck: I can't both keep focus-events off (to avoid the
false-activity dot) and silence the notice. The two requests work against
each other.

What would resolve it (either is fine; the second is better)

  1. A suppress toggle — a settings.json key or env var to hide the

focus-events-off notice for users who have intentionally disabled it.

  1. Fix the root cause (preferred) — if the focus-out re-render

(#30199) no longer wrote pane-activity stdout on focus change, I could
leave focus-events on, the notice would go away on its own, and I'd
get the focus-aware behavior Claude Code wants. If that re-render were
suppressed, or focus-out handled without emitting stdout, X→ no false
activity → I'd happily re-enable.

Environment

  • Claude Code 2.1.195
  • tmux 3.6b
  • macOS 26.5.1 (Apple silicon)
  • iTerm2

Note: I don't have the exact notice string captured here — happy to paste
the literal text if it helps pin the code path.

View original on GitHub ↗

This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗