Install
Run these two commands in Claude Code:
/plugin marketplace add https://github.com/iamumeransari/claude-show-your-work.git#releases
/plugin install show-your-work@iamumeransari
It supports Ghostty and kitty, on macOS and Linux, with Claude Code 2.1.286 or later. Videos and audio also need ffmpeg: install it with your package manager (brew install ffmpeg on macOS), or ask Claude to install it. HTML pages need Chrome, Chromium or Playwright's browser, and PDFs need poppler (brew install poppler).
When the install finishes, a short onboarding shows you around. Run /show-your-work at any time to change your settings.
Usage
Claude shows you its work in the chat whenever it builds or changes something visual. You can also ask for it directly:
- "Give me four directions for the homepage hero and show them side by side."
- "Build the sign-up form, test it, and show me the recording."
- "Fix the billing toggle and show me before and after."
Visual QA with before-and-after recordings
When Claude builds a feature or fixes a bug, it tests the change with Playwright, records the run and plays the recording in the chat, with everything you need to review the work in one place:
- Before and After: For any change, from a new feature to a bug fix, Claude records the same steps on the old version and the new one. Compare then plays both side by side, in sync.
- Change Markers: Every change Claude made is listed beside the video with its timestamp, and clicking one jumps straight to the moment it shows up.
- Live Checks: Each test check turns green or red as the video reaches it, so you can see exactly where the fix works and where something still fails.
- One Place to Review: You don't need to open a browser, rerun the tests or read through logs, because the recording and its results are right there in the chat.
Images
Whatever Claude designs, you see it right in the chat: landing pages, app screens, components, design concepts, slides, charts and generated images. Ask for a few directions and they appear side by side, then keep iterating on the one you like.
- Compare Directions: Several concepts show together, so you can pick one at a glance instead of opening files one by one.
- Every Version Kept: Each new version lands in the same player, and History lets you step back through every earlier draft.
- Before and After: Switch between the old and new design, or put them side by side, to see exactly what changed.
Video
Beyond product QA, Claude can show you a video of almost anything it works on. Building a website and want to see how it feels as you scroll from top to bottom? Just ask, and the recording plays in the chat, animations and all.
Making an ad, an animation or a launch video? Each cut plays right in the chat, in a full-featured video player:
- Video Controls: Play, pause, scrub through the timeline, and skip forward or back to the moment you want. A video with sound plays with its sound; Mute turns sound off for the session.
- Timestamps: The sidebar walks you through what happens in the video, step by step. Each step is timestamped, so one click takes you right to that moment.
- Compare Versions: When Claude makes a new version of a video, it opens in the same player. You can flip between drafts in History or play the old and new versions side by side, in sync.
- Quick Functions: Open the video in QuickTime Player for a bigger view, or save it straight to your Downloads folder in one click.
Terminals
show-your-work supports Ghostty and kitty, on macOS and Linux. Pictures work there straight away.
- Rex and the Herdr app: pictures and videos draw, but Claude Code only turns them on there when it starts with
CLAUDE_CODE_FORCE_TERMINAL_IMAGES=1. The notice's Turn on pictures button adds a line to your shell profile that sets it in that terminal only, and copies a command to reopen the chat.
- Warp, WezTerm and Konsole: these support the kitty graphics protocol, but not the Unicode placeholders Claude Code draws pictures with, so pictures can't show in them yet.
- Other terminals built on Ghostty or kitty: Claude Code doesn't recognise them and leaves pictures off. Start it with
CLAUDE_CODE_FORCE_TERMINAL_IMAGES=1 (the notice copies a command that does this), or add export CLAUDE_CODE_FORCE_TERMINAL_IMAGES=1 to your shell profile.
- tmux: works inside Ghostty or kitty. Claude Code leaves pictures off in tmux unless it starts with
CLAUDE_CODE_FORCE_TERMINAL_IMAGES=1, so the first time, the plugin turns that on for new tmux panes and the notice copies a command that reopens the chat with it. The plugin also turns on allow-passthrough for its own pane and passes the pictures through. Nothing in your tmux config is changed.
Versions 0.6.7 to 0.6.9 offered a Turn on pictures button in Warp, WezTerm and Konsole, which added a line to your shell profile. It made pictures draw as a grid of boxes, so the plugin now removes that line by itself.
FAQ
Yes, Claude Code can show images in the terminal with the show-your-work plugin. Once it's installed, Claude shows screenshots, designs, charts and other images right in the chat. It works in Ghostty and kitty.
Yes, Claude Code can play videos in the terminal with the show-your-work plugin. It plays screen recordings, animations, ads and launch videos inside the Claude Code chat. It comes with a feature-rich video player, with scrubbing, skip controls, clickable timestamps and side-by-side comparisons.
You can see what Claude Code built by installing the show-your-work plugin. Whenever Claude builds or changes something visual, it takes a screenshot or records it and shows you the result in the chat. You don't have to switch to a browser and find the page yourself.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
