SlimSnap: A CLI ügynökeid új szeme
A képernyőképek problémája az AI-asszisztált fejlesztésben
Ha rendszeresen használsz terminálalapú kódoló ügynököket – legyen szó Claude Code-ról, Aider-ről vagy Codex CLI-ről –, biztosan belefutottál már ebbe a frusztráló korlátba: ezek az eszközök remekül olvasnak és írnak kódot, de a felhasználói felületet egyszerűen nem látják.
Tegyük fel, hogy egy hibás gombot kell megmagyaráznod. Kénytelen vagy egy egész bekezdést írni: "a piros hibaüzenet a fizetési oldal jobb felső sarkában." Az ügynök pedig próbálja elképzelni, amit leírtál – sokszor sikertelenül.
Itt jön képbe a SlimSnap, egy ügyes macOS-segédprogram, amely bármely képernyőképet strukturált JSON-ná alakít, amit a terminálbeli ügynökeid gond nélkül feldolgozhatnak.
A működés: képrögzítés, kommentezés, továbbítás
A folyamat gyönyörűen egyszerű:
Rögzítés – Nyomd meg a ⌘⇧S billentyűkombinációt, és jelöld ki a képernyő tetszőleges részét. A natív macOS API-kat használja, így nem kell plusz függőségeket telepíteni.
Kommentezés – Egyszerűen dobálhatsz rá nyilakat, magyarázó buborékokat és kiemeléseket, hogy pontosan megmutasd, mi a probléma.
JSON másolása – Egyetlen kattintással strukturált JSON-ná alakul minden, amit bármely terminálügynökbe beilleszthetsz.
A kimenet meglepően részletes. Tartalmazza a rögzítés időpontját, az alkalmazás nevét, a képernyő méreteit, és ami a legfontosabb: a detektált elemek strukturált tömbjét. Minden elem rendelkezik típussal (gomb, beviteli mező, felirat), a tényleges szöveges tartalommal, valamint normalizált 0-1 koordinátákkal.
Ez utóbbi a lényeg. Amikor az ügynököd tudja egy elem pontos pozícióját – mondjuk "a beállítások modális ablakában a harmadik beviteli mező" – , akkor precízen tud reagálni, nem kell találgatnia.
Miért fontos ez a fejlesztői munkafolyamatokban?
A SlimSnap itt ragyog igazán: a token-hatékonyság terén.
Ha nyers képernyőképet illesztesz be a ChatGPT webes felületére, az API downsampling és tömörítés alkalmaz. De a képeket fogadó CLI ügynökök esetében is elkezded ütni az API-limitet – egy tipikus képernyőkép körülbelül 1568 vision tokenbe kerül a Sonnet modelleken, Opus 4.7/4.8-on pedig akár 4784-be is.
A SlimSnap JSON exportja általában 600-800 token között mozog. Ez nagyjából 55%-os megtakarítás a Sonnet modelleken, Opus modelleken pedig akár 85%-os. Ha hosszú debugolási vagy refaktorálási sessziókban gondolkodsz tucatnyi iterációval, ezek a megtakarítások gyorsan összeadódnak.
Több megmaradt token a kontextusablakban azt jelenti, hogy több hely marad a tényleges kódnak, a hibanaplóknak és az ügynök gondolkodásának. A kontextus-büdzsé tovább stretch-elődik.
Privacy-first architektúra
Egy dolog, amit különösen értékelek: a SlimSnap minden OCR-feldolgozást lokálisan, a saját Mac-en végez. A képernyőképek soha nem hagyják el a gépedet. Nincs regisztráció, nincs szerver az útban. Ha érzékeny alkalmazásokkal vagy saját fejlesztésű interfészekkel dolgozol, ez jelentős szempont.
A JSON séma maga is nyílt (MIT licenc) és elérhető a GitHub-on. Validálhatsz vele, írhatsz saját exportőröket, vagy akár kézzel is szerkeszthetsz érvényes JSON-t, ha más OCR pipeline-okkal szeretnéd integrálni.
A Claude Code Skill
Claude Code felhasználóknak a SlimSnap egy külön skill-t kínál, amely automatikusan detektálja a képrögzítéseket. Egy kis konfigurációs fájlt ír a ~/.slimsnap/config.json útvonalra a mentési preferenciáiddal, és a skill ebből tölti be a legújabb JSON-t az ügynököd kontextusába. Teljesen gördülékeny integráció, kézi fájlnyitogatás nélkül.
Mikor jobb a JSON a pixeleknél?
Íme az őszinte trade-off: elemszintű munkához – specifikus gombok javítása, űrlapmezők frissítése, elrendezési hibák korrigálása – a JSON objektíven jobb. Az ügynököd precíz koordinátákat és kinyert szöveget kap, nem pedig pixeleit kell értelmeznie.
De "vibe check"-ekhez – tetszik-e a dizájn, passzol-e a színpaletta – továbbra is érdemes lehet a nyers képet beilleszteni. Semmi sem akadályoz meg abban, hogy mindkettőt elküldd: a JSON-t a precíz célzáshoz, a képet pedig az esztétikai értékeléshez.
A lényeg
A SlimSnap egy specifikus, de valós fájdalompontot old meg az AI-asszisztált fejlesztési munkafolyamatban. Ha komolyan beleásod magad a CLI-alapú ügynökökbe, és gyakran kell UI-kat megvitatnod, érdemes bepakolni az eszköztáradba. Már a token-megtakarítás önmagában is igazolja a beállítást, és a lokális feldolgozás nullára csökkenti a privacy aggályokat.
Jelenleg csak macOS-en érhető el, de mivel a séma nyílt, csak idő kérdése, hogy valaki más platformokra is építsen kompatibilis exportőröket.
Nézzél körbe a slimsnap.ai oldalon – a produktivitás-növekedés UI-intenzív debugolási sessionök során jelentős lehet.
Unod már a UI-k bekezdésekben való leírását? Néha a legjobb eszköz az, ami azt fordítja le, amit látsz, arra, amit az ügynököd ért.