{"version":"2.1.310","anchor":"tmux-image-capability-detection-reworked-in-terminal-probe","canonical_anchor":"tmux-image-capability-detection-reworked-in-terminal-probe","heading":"Inline terminal images inside tmux","tier":"notice","area":"Terminal Images","scope":"individual","heads_up":false,"url":"https:\/\/changelogs.core-directive.com\/v\/2.1.310\/e\/tmux-image-capability-detection-reworked-in-terminal-probe","release_url":"https:\/\/changelogs.core-directive.com\/v\/2.1.310","markdown":"### Inline terminal images inside tmux\n\nClaude Code now checks tmux itself to decide whether kitty or iTerm2 images can show, keeps them in place, and explains how to fix it when they can't\n\n**What**\n\ntmux is a terminal multiplexer, a program that splits one terminal window into panes. Some terminals, such as kitty and iTerm2, can show images inline. Claude Code's handling of these images inside tmux was reworked:\n\n- At startup, Claude Code asks tmux itself for facts about the pane (whether passthrough is allowed, focus events, pane position) and answers the kitty and iTerm2 image questions from that, logged as `tmux images: passthrough ...`. It no longer runs `tmux display-message -p #{client_termtype}` there.\n\n- Image detection now has a separate `tmux` input, true when TMUX is set and STY is not, so tmux is no longer treated like screen. Inside tmux, image support defaults to off, with the reason \"env: inside tmux, where the terminal cannot be asked whether it reads files\". `CLAUDE_CODE_FORCE_TERMINAL_IMAGES` still overrides this. Screen is now labelled \"env: inside screen\".\n\n- When TMUX is set, images are present, tmux passthrough is not 'off' and kitty or iTerm2 support is detected, Claude Code tracks where the pane sits and re-sends or redraws images when the pane moves, the terminal regains focus or the window is resized. Sync markers are skipped in that case.\n\n- Image escape codes are wrapped for tmux passthrough, and large iTerm2 images are split into `MultipartFile` and `FilePart` chunks.\n\n- New diagnostic code queries tmux for `client_termtype`, `allow-passthrough`, `focus-events` and other pane fields and produces fix messages such as \"images inside tmux need tmux 3.3 or later with allow-passthrough and focus-events on\" and \"tmux does not know which terminal is outside it, so Claude Code draws no images here\". No caller for it was seen.\n\n- A denial for tmux passthrough now comes with a \"tmux-passthrough\" fix tag.\n\n**Why**\n\nInline images inside tmux are decided differently, so they may now show where they did not before, or stop showing. Where they cannot show, there is now a specific explanation of what to change in tmux.\n\n- Area: Terminal Images\n- Tier: You'll notice\n- Useful: 2\/5\n- Signal: 1\/5\n- Scope: individual\n- Heads-up: no"}