termpeek 0.2.0

Preview images, video, PDFs, code, diffs and X posts from inside an AI coding CLI that can't show them to you.

Claude Code, Codex, Gemini CLI and Hermes all run a TUI that owns the terminal. When a tool writes an image you get Read image (42 KB) — the agent can see it, you can't. termpeek renders where the TUI never repaints.

Since 0.1.0

X posts — paste a link, see the card. No API key: it uses the endpoint behind embedded posts, with the X API and cookie auth as fallbacks.

Several items at once — --gallery tiles them, --carousel steps through. Types can be mixed.

Linux actually works. 0.1.0 returned "no transport" on Linux without tmux, so it could display nothing at all, while the README claimed support. It now spawns $TERMINAL or the first installed emulator, and reports honestly when there is no display.

Previews that open by themselves — a Claude Code hook that previews media as the agent writes it. Never blocks, skips code and diffs, suppresses repeats.

An MCP server — one adapter for Codex, Gemini and anything else MCP-speaking. Unlike image-oriented MCP servers, it renders to your terminal and returns text to the model.

Caching — measured first, then applied only where it paid:

	Cold	Warm
X post card	1441 ms	186 ms
PDF page	476 ms	119 ms

Images (~90 ms) and diffs (~100 ms) are left alone; caching those would risk staleness to save nothing.

Install

git clone https://github.com/0xNyk/termpeek
cd termpeek && ./install.sh

Needs chafa and timg; bat, git-delta, ffmpeg, jq and tmux extend it. With no graphics protocol you get Unicode block art, which works anywhere.

Verified

95 tests, shellcheck clean, CI on macOS (bash 3.2) and Linux.

Claude Code is verified end to end. The MCP server is verified at the protocol level but not yet driven from Codex or Gemini — marked as such in the README rather than claimed.