Session Image Extract

세션 로그에서 이미지 되찾기

대화에 붙인 이미지는 세션 로그에 base64로 그대로 남는다. 원본이 사라져도 로그가 있으면 복원된다. 사용자가 "아까 보낸 사진"이라고 하면 파일을 찾아 헤매지 말고 여기서 꺼낸다.

로그 위치는 ~/.claude/projects//*.jsonl이다. 예를 들어 /Users/me/projects/my app은 -Users-me-projects-my-app이 된다(영숫자가 아닌 문자는 전부 -).

절차

1. 뭐가 있는지 먼저 본다

python3 scripts/extract_session_images.py --list

번호·역할·시각·형식·해상도·바이트·해시가 나온다. 꺼내기 전에 반드시 목록을 먼저 본다 — 한 세션에 수십 장이 쌓여 있는 경우가 흔하고, 같은 화면을 연속으로 찍은 것도 많다.

2. 범위를 좁힌다

사용자가 "16시간 전에 보냈어"처럼 말하면 시각으로 좁히는 게 가장 빠르다.

# 사용자가 붙인 것만, 특정 시각대만
python3 scripts/extract_session_images.py --role user \
  --since 2026-07-30T01:00 --until 2026-07-30T01:30 -o ./out

# 번호로 집는다
python3 scripts/extract_session_images.py --index 14-29 -o ./out

# 형식으로 집는다 (사용자가 "webp야"라고 알려준 경우)
python3 scripts/extract_session_images.py --media-type webp -o ./out

주요 옵션:

| 옵션 | 용도 | |---|---| | --role user\|assistant\|any | 누가 붙인 것인지 | | --since / --until | 로컬 시각 기준 범위 | | --index 3 --index 14-29 --index 1,5,9-12 | 번호 선택 | | --media-type webp | 형식 필터 | | --dedupe | 내용이 같은 것은 한 장만 | | --to-png | 꺼낼 때 png 변환 | | --session | .jsonl 을 직접 지정 | | --latest | 가장 최근 세션 파일 하나만 | | --tz 9 | 시각 표시 기준 (기본 +9) |

꺼내면 manifest.json이 같이 생긴다. 어느 파일이 몇 번·몇 시 것인지 나중에 대조할 때 쓴다.

알아둘 것

• 로그의 시각은 UTC다. 스크립트가 --tz(기본 +9)로 변환해 보여준다. 사용자가 "새벽 1시 20분"이라고 하면 로그에는 16:20:26Z로 있다. 이걸 안 맞춰서 엉뚱한 이미지를 꺼내는 사고가 실제로 났다.
• webp는 그대로 못 쓰는 곳이 많다. Threads는 webp 업로드를 거부한다. --to-png를 쓰거나 sips -s format png로 변환한다.
• 연속 캡처는 거의 같은 그림이다. 같은 화면을 1~2분 간격으로 찍은 묶음이 흔하다. 해상도와 해시가 같으면 내용도 같으니 --dedupe로 줄이고, 시각이 다른 것만 골라 쓴다.
• 가로 캡처를 여러 장 올리면 잘린다. 맥 전체 화면 캡처는 보통 2000×1125 같은 가로다. SNS 캐러셀은 세로 타일로 센터 크롭하므로 오른쪽에 있는 숫자가 날아간다. 여러 시점을 보여줘야 하면 필요한 영역만 잘라 한 장으로 합친다.
• 개인정보는 올리기 전에 가린다. 앱 스크린샷에는 이름·핸들·아바타·이메일이 같이 찍힌다. 발행용이면 해당 영역을 블러 처리한다.

from PIL import Image, ImageFilter
im = Image.open("shot.png").convert("RGB")
for box in [(1088,150,1172,232), (1030,240,1230,285)]:   # 아바타, 이름
    im.paste(im.crop(box).filter(ImageFilter.GaussianBlur(24)), box)
im.save("masked.png")

• 로그는 크다. 26MB짜리도 나온다. 통째로 읽지 말고 이 스크립트처럼 줄 단위로 흘려 읽는다.
• 이미지 블록은 {"type":"image","source":{"data":"...","media_type":"image/webp"}} 모양으로 중첩돼 있다. 스크립트는 메시지 트리를 재귀로 훑으므로 구조가 조금 달라져도 걸린다.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Tygb99
• Source: Tygb99/claude-code-session-skills
• License: MIT

Install and usage instructions live in the source repository linked above.