GitHub - APIANT/shellshot: A macOS menubar app that sends screenshots and short recordings directly into a running Claude Code iTerm2 terminal session. Also supports sending screenshots from an iPad/iPhone on the same WiFi network. · GitHub
/" data-turbo-transient="true" />
Skip to content
Search or jump to...
Search code, repositories, users, issues, pull requests...
-->
Search
Clear
Search syntax tips
Provide feedback
--><br>We read every piece of feedback, and take your input very seriously.
Include my email address so I can be contacted
Cancel
Submit feedback
Saved searches
Use saved searches to filter your results more quickly
-->
Name
Query
To see all available qualifiers, see our documentation.
Cancel
Create saved search
Sign in
/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up
Appearance settings
Resetting focus
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
APIANT
shellshot
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star
main
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>20 Commits<br>20 Commits
app
app
media
media
prototype
prototype
tools
tools
.gitignore
.gitignore
LICENSE
LICENSE
README.md
README.md
View all files
Repository files navigation
ShellShot
A macOS menubar app that sends screenshots and short recordings directly into a running Claude Code iTerm2 terminal session. Also supports sending screenshots from an iPad/iPhone on the same WiFi network.
⬇ Download for Apple Silicon (v0.1.0) — or build from source.
Features
⌥⌘C — area capture, preview, annotate with arrows, send
⌥⌘R — record a region as a frame sequence (perceptually deduped, max 20 frames)
Session picker across all live Claude Code sessions; preselects the focused one
"Copy to Clipboard" button copies the annotated capture at full resolution instead of sending
iPad/iPhone sharing — send a screenshot from an iPad or iPhone on the same Wi-Fi into a Mac session via an auto-generated Shortcut
Images sent to Claude are downscaled to keep token usage reasonable
Launch at login; captures auto-prune after 7 days
Supports macOS + iTerm2 only. tmux, Kitty, and WezTerm adapters are possible.
Install
Requires macOS 13+ and iTerm2 with Settings → General → Magic → Enable Python API .
Download (Apple Silicon)
Grab the latest release, unzip, and move ShellShot.app to /Applications. The build is ad-hoc signed (not notarized), so clear Gatekeeper's quarantine once:
xattr -dr com.apple.quarantine /Applications/ShellShot.app
Build from source
Requires Python 3 (build time only; the app embeds a self-contained sidecar).
git clone https://github.com/APIANT/shellshot ~/shellshot<br>cd ~/shellshot<br>python3 -m venv prototype/.venv<br>prototype/.venv/bin/pip install iterm2 pyinstaller<br>./app/build-app.sh<br>open /Applications/ShellShot.app
macOS will prompt once for Screen Recording and once for iTerm2 automation. The installed app is self-contained.
iPad/iPhone sharing
Send a screenshot from an iPad or iPhone (on the same Wi-Fi as the Mac) into a Claude Code session:
In the ShellShot menu, enable iPad Sharing , then choose Set Up iPad Shortcut… — a QR code appears with the Mac's address and a token baked in.
On the device, point the Camera at the QR code, tap the banner, and Add Shortcut .
To use it: take a screenshot, tap Share , and pick ShellShot . Choose which Claude session to send to (the focused one is marked ●), add an optional message, and it posts to the Mac.
The Mac runs a small token-guarded HTTP listener (port 8472) for this; it's off by default and LAN-only. Images are downscaled the same way as local captures.
License
MIT © APIANT Inc.
About
A macOS menubar app that sends screenshots and short recordings directly into a running Claude Code iTerm2 terminal session. Also supports sending screenshots from an iPad/iPhone on the same WiFi network.
Topics
macos
screenshot
iterm2
menubar-app
claude-code
Resources
Readme
License
MIT license
Uh oh!
There was an error while loading. Please reload this page.
Activity
Stars
stars
Watchers
watching
Forks
forks
Report repository
Releases
ShellShot v0.1.0 (Apple Silicon)
Latest
Jun 10, 2026
Packages
Uh oh!
There was an error while loading. Please reload this page.
Contributors
Uh oh!
There was an error while loading. Please reload this page.
Languages
Swift<br>83.3%
Python<br>14.0%
Shell<br>2.7%
You can’t perform that action at this time.