SlimSnap

SlimSnap이란?

SlimSnap은 터미널 기반 코딩 에이전트가 읽을 수 있는 JSON으로 스크린샷을 변환하는 macOS 앱입니다. Claude Code, Aider, Codex CLI 같은 도구에 이미지를 붙여 넣지 않고 UI 세부 정보를 전달하고 싶을 때 사용하도록 설계되었습니다.

이 워크플로는 캡처, 주석, OCR, 내보내기를 결합합니다. 사용자는 화면에서 영역을 선택하고 화살표나 콜아웃 같은 시각적 표시를 추가한 뒤, 요소 텍스트, 바운딩 박스, 주석 데이터를 포함한 구조화된 JSON 표현을 복사합니다. 목표는 Mac에서 캡처 과정을 로컬로 유지하면서, 스크린샷 내용을 텍스트 전용 환경에서도 사용할 수 있게 하는 것입니다.

SlimSnap은 MIT 라이선스로 GitHub에 공개 JSON 스키마도 제공합니다. 따라서 내보낸 형식은 앱 밖에서도 검증하거나 재사용할 수 있습니다. 제품 페이지는 이를 터미널, SSH 세션, 기타 텍스트 전용 워크플로처럼 이미지를 허용하지 않는 곳으로 스크린샷 문맥을 옮기는 방법으로 소개합니다.

주요 기능

• 기본 macOS 화면 캡처: 사용자는 ⌘⇧S를 누르고, 드래그해 영역을 선택한 뒤, 놓아서 스크린샷 영역을 캡처합니다.
• 주석 도구: 화살표, 콜아웃, 하이라이트로 에이전트가 특정 UI 요소나 문제를 정확히 보게 할 수 있습니다.
• JSON 내보내기: 캡처 결과를 구조화된 JSON으로 복사해 터미널 에이전트와 다른 텍스트 전용 도구에 붙여 넣을 수 있습니다.
• 내장 OCR: 앱이 스크린샷에서 보이는 라벨, 버튼, 오류 메시지를 읽어 출력에 포함합니다.
• 요소 바운딩 박스: 출력 요소에 정규화된 좌표가 포함되어 downstream 도구가 레이아웃과 위치를 파악하는 데 도움이 됩니다.
• Mac에서 로컬 처리: 캡처와 OCR이 기기에서 실행되며, 계정 생성이나 서버 업로드가 필요 없습니다.
• 공개 스키마: JSON 스키마가 MIT 라이선스로 GitHub에 게시되어 검증이나 커스텀 내보내기를 허용합니다.

SlimSnap 사용 방법

Mac 앱을 설치한 다음, 캡처 단축키를 사용해 공유하려는 화면 부분을 선택합니다. 버튼을 강조하거나 오류 메시지를 표시하는 등 주의를 끌기 위한 필요한 주석을 추가합니다.

캡처 후 생성된 JSON을 복사해 CLI 코딩 에이전트 같은 텍스트 입력 도구에 붙여 넣습니다. Claude Code 스킬을 사용하는 경우, SlimSnap은 스킬이 저장된 JSON 캡처를 자동으로 찾을 수 있도록 작은 로컬 설정 파일도 작성합니다.

사용 사례

• 터미널 에이전트에서의 UI 디버깅: 레이아웃과 텍스트 세부 정보가 이미 JSON으로 추출된 깨진 인터페이스의 스크린샷을 공유합니다.
• 반복적인 코드 리뷰 또는 수정 프롬프트: 긴 시각 설명을 쓰지 않고도 에이전트가 특정 버튼, 폼 필드, 오류 상태를 보게 할 수 있습니다.
• SSH 또는 원격 세션: 이미지 붙여넣기가 불가능한 환경으로 스크린샷 문맥을 옮깁니다.
• CI 또는 로그 기반 문제 해결: 스크린샷이 들어맞지 않는 텍스트 전용 로그나 커밋 메시지에 구조화된 UI 문맥을 붙여 넣습니다.
• 커스텀 워크플로: 공개된 스키마를 사용해 다른 OCR 파이프라인이나 직접 만든 익스포터에서 호환되는 JSON을 생성합니다.

FAQ

SlimSnap이 내 스크린샷을 서버로 업로드하나요? 아니요. 페이지에 따르면 캡처와 OCR은 Mac에서 로컬로 실행되며, 스크린샷은 기기를 떠나지 않습니다.

이미지를 읽지 못하는 도구와도 작동하나요? 네. 이 제품은 스크린샷을 직접 붙여 넣을 수 없는 터미널 에이전트와 다른 텍스트 전용 대상에 맞춰 만들어졌습니다.

스키마는 공개인가요? 네. JSON 스키마는 MIT 라이선스로 GitHub에 게시되어 있고, 페이지에 따르면 Claude Code 스킬도 오픈되어 있습니다.

Claude Code 스킬을 사용하려면 Mac 앱이 필요한가요? 아니요. 스킬은 앱 밖에서 만들어진 것이라도 유효한 SlimSnap JSON 파일이라면 사용할 수 있습니다.

SlimSnap은 Windows나 Linux에서 사용할 수 있나요? 현재는 아닙니다. 페이지는 지금은 Mac 전용이라고 설명하며 다른 플랫폼 요청을 받고 있습니다.

대안

• AI 채팅 앱의 기본 스크린샷 공유: 일회성 이미지 질문에는 유용하지만, 터미널 에이전트나 텍스트 전용 워크플로용으로는 설계되지 않았습니다.
• UI에 대한 수동 텍스트 설명: 스크린샷이 단순할 때는 가능하지만, 세부 레이아웃에서는 더 느리고 오류가 나기 쉽습니다.
• OCR과 커스텀 JSON 익스포터: 스크린샷을 구조화된 텍스트로 바꾸는 자체 파이프라인을 만들려는 팀에 유연한 선택지입니다.
• 범용 화면 녹화 또는 주석 도구: 인터페이스를 캡처하고 표시할 수는 있지만, 보통 OCR과 바운딩 박스가 포함된 에이전트 판독 가능 JSON은 내보내지 않습니다.