convez.ai
PluginProdutividadeIntermediário
APIANT

ShellShot

APIANT/shellshot

Capture e envie screenshots direto para Claude Code no iTerm2

Ver no GitHub
InicialPluginScore · de 0 a 100

App de menu da macOS que captura screenshots e gravações de tela, enviando-os diretamente para sessões Claude Code no iTerm2. Suporta também compartilhamento de capturas de iPad/iPhone na mesma rede WiFi, com anotações e deduplica de frames para otimizar tokens.

Instalação

$npx convez-ai APIANT/shellshot

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 1 mês
Versão
v0.1.0
Issues abertas
0
Contribuidores
1

Casos de uso

  • Enviar capturas de tela anotadas para análise em sessões Claude Code
  • Compartilhar screenshots de iPad/iPhone para debugging remoto
  • Capturar sequências de frames para análise de UI/UX com IA

Veredito

Ferramenta prática e bem pensada para fluxo de desenvolvimento em macOS, integrando captura visual direta com Claude Code. Limitado ao ecossistema Apple (macOS + iTerm2), mas solve um problema real de compartilhamento visual em sessões de coding.

README

A tradução para o português deste README ainda está na fila.

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.

ShellShot demo

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
cd ~/shellshot
python3 -m venv prototype/.venv
prototype/.venv/bin/pip install iterm2 pyinstaller
./app/build-app.sh
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:

  1. 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.
  2. On the device, point the Camera at the QR code, tap the banner, and Add Shortcut.
  3. 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.

Ver o original no GitHub

Bom para

Relacionados