Fix mod images in tmux
CHANGELOG · original
Improved a mod's Image to draw inside tmux with allow-passthrough and focus-events on, in kitty, Ghostty, and iTerm2 3.5+ with fullscreen rendering, where it showed only its alt text Open official changelog ↗ Documentation
Documentation excerpt
Configure tmux
When Claude Code runs inside tmux, by default Shift+Enter submits instead of inserting a newline, and desktop notifications don't reach the outer terminal. Add these lines to ~/.tmux.conf, then run tmux source-file ~/.tmux.conf to apply them to the running server:
set -g allow-passthrough on
set -g focus-events on
set -s extended-keys on
set -as terminal-features 'xterm*:extkeys'
To use Shift+Enter, keep the last two lines, then detach from tmux, attach again, and restart Claude Code. To send notifications from a visible pane to Ghostty, Kitty, or iTerm2, keep the allow-passthrough line and restart Claude Code. With this sample, a pane in a window you aren't viewing sends none. Before v2.1.326 or inside tmux older than 3.3, which has no allow-passthrough, set preferredNotifChannel to "iterm2", "kitty", or "ghostty".
A mod's Image needs the allow-passthrough and focus-events lines, along with the other requirements for drawing inside tmux. After you add the lines, also detach from tmux, attach again, and restart Claude Code.
Documentation snapshot · 2026-11-20