SlimSnap

Che cos’è SlimSnap?

SlimSnap è un’app macOS che trasforma gli screenshot in JSON leggibile da agenti di coding basati su terminale. È pensata per i casi in cui vuoi comunicare dettagli dell’interfaccia a strumenti come Claude Code, Aider o Codex CLI senza incollare un’immagine.

Il flusso di lavoro combina cattura, annotazione, OCR ed export. Gli utenti selezionano un’area sullo schermo, aggiungono indicatori visivi come frecce o callout e copiano una rappresentazione JSON strutturata che include il testo degli elementi, i bounding box e i dati delle annotazioni. L’obiettivo è rendere il contenuto degli screenshot disponibile in ambienti solo testo, mantenendo il processo di cattura locale sul Mac.

SlimSnap pubblica anche su GitHub uno schema JSON aperto sotto licenza MIT, così il formato esportato può essere validato o riutilizzato fuori dall’app. La pagina del prodotto lo presenta come un modo per portare il contesto degli screenshot in contesti in cui le immagini non sono accettate, come terminali, sessioni SSH e altri flussi solo testo.

Funzionalità principali

• Cattura schermo nativa su macOS: gli utenti premono ⌘⇧S, trascinano per selezionare un’area e rilasciano per catturare una regione dello screenshot.
• Strumenti di annotazione: frecce, callout ed evidenziazioni consentono agli utenti di indicare all’agente un elemento UI specifico o un problema.
• Export JSON: le catture vengono copiate come JSON strutturato, così possono essere incollate in agenti da terminale e altri strumenti solo testo.
• OCR integrato: l’app legge etichette visibili, pulsanti e messaggi di errore dallo screenshot e li include nell’output.
• Bounding box degli elementi: gli elementi in output includono coordinate normalizzate, che aiutano gli strumenti downstream a ragionare su layout e posizione.
• Elaborazione locale su Mac: cattura e OCR vengono eseguiti sul dispositivo, senza bisogno di account o upload su server.
• Schema aperto: lo schema JSON è pubblicato su GitHub sotto MIT, consentendo validazione o exporter personalizzati.

Come usare SlimSnap

Installa l’app Mac, poi usa la scorciatoia di cattura per selezionare la parte di schermo che vuoi condividere. Aggiungi eventuali annotazioni necessarie per attirare l’attenzione, come evidenziare un pulsante o segnare un messaggio di errore.

Dopo la cattura, copia il JSON generato e incollalo in uno strumento che accetta testo, come un agente di coding CLI. Se usi la skill di Claude Code, SlimSnap scrive anche un piccolo file di configurazione locale, così la skill può trovare automaticamente le catture JSON salvate.

Casi d’uso

• Debug UI in un agente terminale: condividi uno screenshot di un’interfaccia difettosa con layout e dettagli testuali già estratti in JSON.
• Prompt iterativi di code review o correzione: indica a un agente un pulsante, un campo del form o uno stato di errore specifico senza scrivere una lunga descrizione visiva.
• Sessioni SSH o remote: porta il contesto dello screenshot in un ambiente in cui non è possibile incollare immagini.
• Troubleshooting da CI o log: incolla il contesto UI strutturato in log o commit message solo testo quando uno screenshot non sarebbe adatto.
• Flussi personalizzati: usa lo schema pubblicato per generare JSON compatibile da un’altra pipeline OCR o da un exporter scritto a mano.

FAQ

SlimSnap carica i miei screenshot su un server? No. La pagina dice che cattura e OCR vengono eseguiti localmente sul tuo Mac e che gli screenshot non lasciano la macchina.

Funziona con strumenti che non sanno leggere le immagini? Sì. Il prodotto è pensato per agenti terminale e altre destinazioni solo testo in cui gli screenshot non possono essere incollati direttamente.

Lo schema è aperto? Sì. Lo schema JSON è pubblicato su GitHub sotto MIT e la pagina dice che anche la skill di Claude Code è open.

Mi serve l’app Mac per usare la skill di Claude Code? No. La skill può funzionare con qualsiasi file SlimSnap JSON valido, anche se è stato creato fuori dall’app.

SlimSnap è disponibile su Windows o Linux? Non al momento. La pagina dice che oggi è solo per Mac e invita a richiedere altre piattaforme.

Alternative

• Condivisione nativa degli screenshot nelle app di chat AI: utile per domande occasionali su immagini, ma non pensata per agenti terminale o flussi solo testo.
• Descrizioni testuali manuali della UI: praticabili quando lo screenshot è semplice, ma più lente e soggette a errori per layout dettagliati.
• OCR con exporter JSON personalizzati: un’opzione flessibile per team che vogliono costruire la propria pipeline dagli screenshot al testo strutturato.
• Strumenti generici di screen recording o annotazione: possono catturare e segnare interfacce, ma di solito non esportano JSON leggibile dagli agenti con OCR e bounding box.