Skip to content
Back to search

claude-inline-images

MarketplaceWorks with Claude CodeGitHub

Claude Code mod: images inline in the terminal transcript, as real pixels in kitty, Ghostty and Rex (through tmux and ssh too) or block symbols elsewhere

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/stixzoor--claude-inline-images/badge.svg)](/listings/stixzoor--claude-inline-images)

HTML

<a href="/listings/stixzoor--claude-inline-images"><img src="/api/listings/stixzoor--claude-inline-images/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

At the prompt of a Claude Code terminal session:

/plugin install inline-images --marketplace STiXzoOR/claude-inline-images

Answer `y` to add the marketplace, then pick a scope (user is the usual one).

<details> <summary>From a shell, or in the desktop app</summary>

claude plugin install inline-images --marketplace STiXzoOR/claude-inline-images

In the desktop app, where `/plugin` does not run: click + next to the prompt box, then Plugins, Add marketplace with `STiXzoOR/claude-inline-images`, then Add plugin.

</details>

Update with `claude plugin update inline-images@claude-inline-images`, then restart Claude Code.

Needs

- **Claude Code 2.1.311 or later.** Mods are on by default since 2.1.287. CI tests 2.1.311 and the latest release. - **ImageMagick 7 (`magick`)** to decode. On macOS the built-in `sips` stands in when it's missing. On Ubuntu, the `imagemagick` package is version 6, which has no `magick`: use the official AppImage from the ImageMagick releases, extracted with `--appimage-extract` so it needs no FUSE.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 16 lines
  1. {
  2. "name": "claude-inline-images",
  3. "owner": {
  4. "name": "STiXzoOR",
  5. "url": "https://github.com/STiXzoOR"
  6. },
  7. "metadata": {
  8. "description": "Inline images in the Claude Code terminal transcript."
  9. },
  10. "plugins": [
  11. {
  12. "name": "inline-images",
  13. "source": "./plugins/inline-images"
  14. }
  15. ]
  16. }
README.md · README · 153 lines
  1. # inline-images
  2. [![CI](https://github.com/STiXzoOR/claude-inline-images/actions/workflows/ci.yml/badge.svg)](https://github.com/STiXzoOR/claude-inline-images/actions/workflows/ci.yml)
  3. [![Release](https://img.shields.io/github/v/release/STiXzoOR/claude-inline-images)](https://github.com/STiXzoOR/claude-inline-images/releases)
  4. [![Claude Code](https://img.shields.io/badge/Claude%20Code-2.1.311%2B-d97757)](https://code.claude.com/docs/en/plugins/mods/overview)
  5. [![License: MIT](https://img.shields.io/github/license/STiXzoOR/claude-inline-images)](LICENSE)
  6. A Claude Code mod that draws images in the terminal transcript, under the row they belong to, instead of leaving you with `[Image #1]`.
  7. ![The same test card read in Claude Code: real pixels on the left, block symbols on the right](docs/media/hero.png)
  8. <sub>Real captures from Rex: the left with `CLAUDE_CODE_FORCE_TERMINAL_IMAGES=1`, the right without it, which is what Warp, iTerm2 and Terminal.app get. See [docs/media](docs/media/README.md).</sub>
  9. - **Every image in the conversation:** the ones you paste or drag in, the ones tools return (a `Read` of a picture, browser screenshots, MCP images) and the files Claude sends you with `SendUserFile`. They come back when you `--resume` or `--continue`.
  10. - **Real pixels** in kitty, Ghostty and Rex, including inside tmux and over ssh.
  11. - **Block symbols everywhere else:** each cell picks the closest of 24 block glyphs and two colours, so shapes and colour survive in any truecolor terminal.
  12. - **A lightbox:** `/image N`, or a click on a caption, opens a picture big. Step through the conversation's pictures, zoom toward the pointer with the wheel or trackpad, drag to pan.
  13. Without it, Claude Code shows only this:
  14. ```
  15. ❯ Read test-card.png and tell me in one sentence what it shows.
  16. Read 1 file (ctrl+o to expand)
  17. ⏺ It's a test card for checking inline image rendering: a black-and-white radial sunburst …
  18. ```
  19. ## Install
  20. At the prompt of a Claude Code terminal session:
  21. ```
  22. /plugin install inline-images --marketplace STiXzoOR/claude-inline-images
  23. ```
  24. Answer `y` to add the marketplace, then pick a scope (user is the usual one).
  25. <details>
  26. <summary>From a shell, or in the desktop app</summary>
  27. ```bash
  28. claude plugin install inline-images --marketplace STiXzoOR/claude-inline-images
  29. ```
  30. In the desktop app, where `/plugin` does not run: click + next to the prompt box, then Plugins, Add marketplace with `STiXzoOR/claude-inline-images`, then Add plugin.
  31. </details>
  32. Update with `claude plugin update inline-images@claude-inline-images`, then restart Claude Code.
  33. ### Needs
  34. - **Claude Code 2.1.311 or later.** Mods are on by default since 2.1.287. CI tests 2.1.311 and the latest release.
  35. - **ImageMagick 7 (`magick`)** to decode. On macOS the built-in `sips` stands in when it's missing. On Ubuntu, the `imagemagick` package is version 6, which has no `magick`: use the official AppImage from the ImageMagick releases, extracted with `--appimage-extract` so it needs no FUSE.
  36. ## The lightbox
  37. `/image 3` opens image 3, `/image` the latest, and `/image list` lists them. A click on a picture's caption opens it too.
  38. | | Keys (no click needed) | Mouse and trackpad |
  39. |---|---|---|
  40. | Previous, next | `p` `n` | `❮` `❯`, a thumbnail or its number |
  41. | Zoom | `z` `x` | the wheel or a two-finger scroll, toward the pointer |
  42. | Pan | `w` `a` `s` `d` | drag the picture |
  43. | Fit | `f` or `0` | |
  44. | System viewer | `v` | |
  45. | Close | Esc or `q` | `✕ close` |
  46. With real pixels, a click on the picture also gives it ← → to step and + − to zoom.
  47. While you're zoomed in, a navigator in the top right corner shows the whole picture with the part in view boxed in orange. Past the picture's own resolution, pixels stay sharp squares rather than blurring.
  48. - **Clicks and drags need Claude Code's fullscreen layout** (`/tui fullscreen`), where the lightbox docks beside the transcript. In the default layout it sits above the prompt and the keys and wheel drive it.
  49. - **Block symbols take no drags or clicks on the picture.** Anything laid over a `Raster` blanks it, so there the wheel, the keys and the buttons drive.
  50. - A mod can't cover the whole screen. For that, press `v`.
  51. - Zoom needs ImageMagick (`magick`); with only `sips` the lightbox shows the picture at fit.
  52. ## Where it draws pixels
  53. | Terminal | Draws | Needs |
  54. |---|---|---|
  55. | Ghostty, kitty 0.28+ | Real pixels | Nothing |
  56. | Rex | Real pixels | `CLAUDE_CODE_FORCE_TERMINAL_IMAGES=1` |
  57. | tmux, ssh, from one of the above | Real pixels | `CLAUDE_CODE_FORCE_TERMINAL_IMAGES=1` on the far side, and `set -g allow-passthrough on` in tmux |
  58. | Warp, iTerm2, Terminal.app, VS Code | Block symbols | Nothing |
  59. Claude Code draws real pixels only in terminals whose XTVERSION name is kitty or Ghostty. Rex supports everything the `Image` element needs (kitty images and Unicode placeholders), but it names itself `rex`. Over ssh or inside tmux, Claude Code can't ask the terminal outside what it draws. In both cases the override tells it.
  60. Set the override only where the terminal can draw the images, never in the `env` block of `~/.claude/settings.json`. There it applies in every terminal, and in one that can't draw them, images break instead of falling back to block symbols. A shell alias can set it per terminal, for example only in Rex:
  61. ```bash
  62. alias clauded='CLAUDE_CODE_FORCE_TERMINAL_IMAGES=$([[ $TERM_PROGRAM == rex ]] && echo 1) claude'
  63. ```
  64. On a server you reach from such a terminal, set it in that server's alias unconditionally.
  65. Warp draws kitty images sent inline, but not the Unicode placeholders `Image` relies on ([warpdotdev/warp#16312](https://github.com/warpdotdev/warp/pull/16312) adds them). It stays on block symbols. Last checked on Warp v0.2026.11.11.
  66. ## Settings
  67. `/plugin configure inline-images@claude-inline-images`, or from a shell `claude plugin configure inline-images@claude-inline-images`:
  68. | Setting | Default | |
  69. |---|---|---|
  70. | `renderer` | `auto` | `auto` picks pixels or symbols as above. `symbols`, `blocks` (plain half blocks) or `pixels` force one. |
  71. | `maxColumns` | 64 | The widest a picture is drawn, in columns. |
  72. | `maxRows` | 22 | The tallest, in rows. Raise both for more detail in block symbols. |
  73. ## What it runs
  74. The mod reads the conversation's images, decodes them and draws them. It makes no network or model calls. It runs these programs:
  75. - `magick` to decode a picture to a PNG and a 480-pixel RGBA copy, or on macOS without ImageMagick, `/usr/bin/sips` and `/usr/bin/base64`
  76. - `sh -c 'base64 -d >"$1"'` to write a pasted image to a file first, since ImageMagick 7.1.2 and later refuse a data URI on stdin
  77. - `mkdir -p` and `find <cache> -type f -mtime +7 -delete` for its cache in `$TMPDIR/claude-inline-images`
  78. - `magick <picture> -crop …` when you zoom in the lightbox
  79. - `open` (macOS) or `xdg-open` (Linux) when you press `v` in the lightbox
  80. Decodes are named by content, so a picture seen twice is decoded once.
  81. ## Troubleshooting
  82. - **Block symbols in Rex, or in tmux under Ghostty.** Claude Code doesn't know the terminal draws images: set `CLAUDE_CODE_FORCE_TERMINAL_IMAGES=1` (see the table).
  83. - **A blank box where the picture should be.** The terminal was sent a file it can't open. Since 0.2.2, the mod sends the picture's bytes whenever it runs inside tmux or over ssh. Update, and check that tmux has `allow-passthrough on`.
  84. - **Washed-out colours inside tmux.** Claude Code limits itself to 256 colours in tmux. Set `CLAUDE_CODE_TMUX_TRUECOLOR=1`, and tell tmux your terminal has truecolor: `set -as terminal-features "<your $TERM>:RGB"`.
  85. - **No picture under the row.** Nothing could decode it, so the mod leaves the row as Claude Code drew it. Install ImageMagick 7 so that `magick` is on `PATH`.
  86. - **Nothing drawn at all.** Check `claude --version` (2.1.311 or later) and that `/plugin` lists `inline-images` as enabled. Restart Claude Code after an install or update.
  87. ## How it works
  88. The mod hooks the transcript rows that hold images (`UserMessage`, `ToolResult`, `ToolGroup`) and draws each picture below the row Claude Code drew. For real pixels it hands Claude Code's `Image` element the picture. On the same machine as the terminal, that's the file's path. Inside tmux or over ssh, it's the PNG's bytes (or past the 2 MiB an `Image` takes, the 480-pixel copy), because a terminal on another machine can't open a path on this one. For block symbols it renders the 480-pixel copy into a `Raster` of cells, each one the closest of 24 glyphs (halves, quadrants, eighths) in two colours, averaged in linear light.
  89. ## Develop
  90. The mod lives in [`plugins/inline-images/`](plugins/inline-images). Claude Code runs the copy it installs under `~/.claude/plugins/cache/`, so to try a change, load the clone's mod for one session: `claude --plugin-dir plugins/inline-images`.
  91. ```bash
  92. claude plugin validate . # the marketplace
  93. claude plugin validate plugins/inline-images # the mod
  94. claude plugin test plugins/inline-images
  95. tsc -p plugins/inline-images --noEmit # its types folder appears once Claude Code has loaded the mod from there
  96. ```
  97. [`examples/make-test-card.sh`](examples/make-test-card.sh) draws [`examples/test-card.png`](examples/test-card.png), the card in the screenshot. Ask Claude to read it.
  98. ## Credits
  99. The rule for where Claude Code draws real pixels follows [jarrodwatts/claude-image-view](https://github.com/jarrodwatts/claude-image-view) (MIT).
  100. ## License
  101. [MIT](LICENSE). Changes are in the [changelog](CHANGELOG.md).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.