shot
/shot grabs your terminal window without taking focus, plus a searchable history pane.
Illustration. Actual results depend on the mod, terminal and environment.
Install
/plugin marketplace add davekiss/cc-plugins
/plugin install shot@davekiss
/reload-pluginsRun these commands one at a time in a Claude Code session.
claude plugin marketplace add davekiss/cc-plugins
claude plugin install shot@davekissThen run /reload-plugins in your session, or start a new session.
Please install the Claude Code mod "shot" (https://github.com/davekiss/shot). Before installing, read the Security and Requirements sections of its README and tell me what it reads and writes, which commands it runs, whether it uses the network, and which Claude Code version, OS and terminal it needs. If everything looks fine, run claude plugin marketplace add davekiss/cc-plugins and claude plugin install shot@davekiss, then remind me to run /reload-plugins in my session.Send this to Claude Code so it reads the author’s instructions before installing.
git clone https://github.com/davekiss/shot
cd shot
claude --plugin-dir ./claude-modClone the repository and try it in a local session with --plugin-dir.
What it accesses
Based on the author’s documentation, checked when listed; use claude plugin validate to check for yourself.
Reads
YesReads ~/Screenshots, its .shot-index.json, and env vars such as HOME and TERM_PROGRAM.
Writes files
YesCaptures via shot write PNGs and update ~/Screenshots/.shot-index.json.
Runs commands
YesRuns the shot binary to capture and open to show or reveal screenshots.
Network
YesWhen no shot is installed, the launcher downloads the release binary from GitHub.
Introduction
shot is Dave Kiss's macOS screenshot tool. Its Claude Code plugin (the repo's claude-mod folder) includes a function-hooks module, and this entry covers that mod part:
/shotcaptures your terminal window in the background without moving the cursor or stealing focus (via macOSscreencapture, even when covered or minimized).- History pane: reads
~/Screenshotsand.shot-index.jsonto list your screenshots, including ones other apps or agents took, searchable by on-screen text (OCR) and description, with reveal-in-Finder and open actions.
The same plugin also bundles shot's MCP server and a skill that teaches Claude to capture, mark up, redact and record; those are outside this site's mod scope but are installed with the plugin.
Requires macOS 13+ and Screen Recording permission for your terminal. The plugin uses a shot already on PATH (such as Homebrew) or downloads the matching release binary. No minimum Claude Code version is stated. An optional background describer, off by default, sends screenshots to Claude Haiku via claude -p. The preview is illustrative.
Who it is for
- macOS users who often show Claude a window
- People who want to find old screenshots by their text
Requirements
- Platforms · macOS
- Needs macOS 13+ and Screen Recording permission for your terminal.
- The plugin also installs shot's MCP server and skill; no minimum Claude Code version stated.