Koshi / terminal images
Terminal Images in Koshi
Koshi panes can display terminal images. The session keeps image placement with the terminal grid, while each attached terminal chooses the image protocol it supports.
Supported image protocols
Koshi supports Kitty graphics protocol, iTerm2 inline images, and DEC Sixel raster output.
The terminal reports its capabilities when it attaches. Koshi selects the first supported protocol for that terminal.
- Kitty graphics protocol.
- iTerm2 OSC 1337 inline images.
- DEC Sixel raster data.
Image placement stays with the pane
Koshi keeps an image at its cell placement through scrolling, scrollback, resizing, and screen switches.
Two attached terminals can choose different image protocols while viewing the same session.
Terminals without image support
A terminal that supports none of the image protocols shows `terminal image unavailable` in the cells covered by the image.
The surrounding text and terminal state remain usable.
Disable native image output
Set `image-support #false` in the terminal configuration when native image output is not wanted.
version 1
image-support #falseCommon questions
Does Koshi support terminal images?
Yes. Koshi supports Kitty, iTerm2, and Sixel terminal images.
Do Koshi images survive terminal resizing?
Yes. Koshi keeps image placement through scrolling, scrollback, resizing, and screen switches.
Can image support be disabled?
Yes. Set `image-support #false` in the terminal configuration.