Follow Discord
Sweep 22 Sep 2026 · 17:19Z Build v2.1.280 501 read Stable v2.1.267 Latest v2.1.280 Next v2.1.280 Feeds RSS JSON llms.txt Unofficial
Claude Code v2.1.277 ·

Kitty graphics protocol gains file-based image transfer with an active support probe

Terminal images can now transfer via a temp file instead of only inline bytes, with a real check for whether the terminal supports it

TierYou'll noticehow much it should matter to you
Useful2my rating, 1 to 5
Signal2worth watching, 1 to 5
AreaTerminal Renderingwhat it touches
KindImprovementsin v2.1.277,
Group of 2 You'll notice

Terminal images can now transfer via a temp file instead of only inline bytes, with a real check for whether the terminal supports it

What

Claude Code's terminal image support (the kitty graphics protocol) gained two related improvements:

  • Images can now be sent to kitty-graphics-capable terminals via a file path or shared-memory name (t=f), instead of only as inline base64-encoded byte payloads.
  • A new active probe checks whether the terminal can actually read locally-written image files: it writes a small temp file, sends a file-based image request, and checks the terminal's reply, logging 'Terminal image files: yes/no' with the reason, rather than just assuming support.
  • A new request can query the terminal's cell size in pixels.
  • If the probe says no or is inconclusive, Claude Code falls back to the older inline byte transmission method.

Why

File-based transfer is more efficient than sending image bytes inline, but not all terminals support reading local files this way, so actively probing for support avoids broken images and picks the best method automatically.

See this entry in the whole of v2.1.277 →

Feedback