termshot

Run a command.
Keep the shot.

Termshot runs a command in a headless terminal and saves a PNG. Your agent gets one line of JSON with the file path, exit status, and SHA-256 hash.

Install on macOS
terminal preview
$ git log -3 --oneline

64c4042 Document interrupt handling
ba14d71 Correct rendering docs
d270da4 Build e2e binary in temp folder
git-log.png Exit 0

One command.
Two outputs.

Share the PNG with a reviewer. Let your agent read the JSON to find the file, check the exit status, and verify the capture by hash.

Capture a command

termshot --run "git log -3 --oneline" \
  -o /tmp/git-log.png

JSON excerpt

{
  "status": "ok",
  "command": { "exitStatus": 0 },
  "capture": { "path": "/tmp/git-log.png" }
}

Capture in the background

Termshot draws the terminal itself. No terminal window opens.

Keep failed runs

A command that exits with an error still produces a screenshot.

Share from the CLI

With a publisher configured, send a capture to a GitHub PR or Google Drive.

Get Termshot

Free and open source for macOS.

Homebrew

brew install fayez-nazzal/tap/termshot-cap