Session Id Lookup

세션 이름 → 원본 세션 ID 찾기 (claude · codex · aside)

조회 도구

# 통합 검색 (세 에이전트 전부, 이름 부분일치 AND, 대소문자 무시)
python3 ~/.claude/skills/session-id-lookup/scripts/find_session_id.py 로그인 버그

# 에이전트 한정 / 역방향(ID 앞부분 → 무슨 세션인지) / 필터
python3 ~/.claude/skills/session-id-lookup/scripts/find_session_id.py --agent codex 이미지
python3 ~/.claude/skills/session-id-lookup/scripts/find_session_id.py --id 3f2a91c0
python3 ~/.claude/skills/session-id-lookup/scripts/find_session_id.py --cwd my-app --limit 0

검색어 없이 실행하면 최근 15개(--limit 0이면 전부), --archived-only로 보관분만. 결과에는 시각, [에이전트], 이름, 원본 ID, 로그 경로(+크기), cwd가 나온다. 전체 스캔 약 2초(Codex 1,500여 파일 포함).

에이전트별 구조 — 어디에 뭐가 있는가

claude (Claude Code 데스크톱)

ID가 두 겹이다. list_sessions MCP가 주는 local_는 앱 내부 CCD ID고, 로그 파일명은 cliSessionId다. 둘은 아예 다른 uuid라 local_만 떼서 파일명으로 쓰면 틀린다. 매핑은 앱이 세션마다 남기는 메타데이터 JSON에 있다:

~/Library/Application Support/Claude/claude-code-sessions///local_.json
  → title(사이드바 제목), cliSessionId, cwd, lastActivityAt(ms), isArchived

로그: ~/.claude/projects//.jsonl. 프로젝트 디렉터리명은 cwd의 영숫자 아닌 모든 문자를 -로 바꾼 것 (/Users/me/projects/my app → -Users-me-projects-my-app). 재개: claude --resume (해당 cwd에서).

codex (Codex CLI/Desktop)

로그: ~/.codex/sessions/YYYY/MM/DD/rollout--.jsonl (+ ~/.codex/archived_sessions/). uuid가 곧 세션 ID고 파일 첫 줄 session_meta에 session_id·cwd·originator가 있다. 재개: codex resume .

"이름"은 두 가지가 소스다 — ① thread_name_updated 이벤트의 자동 제목(앱/픽커에 보이는 것, 있으면 이걸 우선), ② 없으면 첫 사용자 프롬프트. 프롬프트를 뽑을 때 주의:

• `···# AGENTS.md instructions...는 시스템 주입이라 건너뛴다. 단 ` 같은 래퍼는 실제 지시문이므로 태그만 벗겨 쓴다.
• 붙여넣은 이미지가 base64로 인라인되어 한 줄이 수 MB일 수 있다. 바이트 상한에 걸쳐도 그 줄은 파싱해야 프롬프트를 놓치지 않는다.
• 전체의 ~20%는 이름이 아예 없다: 팀 서브에이전트 세션(지시가 developer 메시지로 옴), 시작 직후 죽은/중단된 세션. 이런 건 날짜·cwd·--id로 찾는 수밖에 없다.
• ~/.codex/history.jsonl은 갱신이 멈춰 있어 인덱스로 못 쓴다. Codex 데스크톱 앱 저장소(~/Library/Application Support/Codex/)는 Chromium 프로필이라 제목 DB가 없다.

aside (어사이드)

제목·ID는 SQLite에 있다: ~/.aside/u/0/state.db의 sessions 테이블 (id, title, cwd, created_at, updated_at, archived_at). WAL 모드라 읽기 전용으로 열 것 (sqlite3 -readonly 또는 uri mode=ro).

로그: ~/.aside/u/0/sessions/_/messages.jsonl (날짜=생성일이라 id로 찾을 땐 *_ glob). 루틴 자동 실행 세션은 제목이 서로 같기 쉬우므로 날짜로 구별한다.

결과 검증과 이어지는 작업

• 같은 이름의 세션이 여럿이면 마지막 활동 시각·로그 크기로 사용자에게 어느 쪽인지 확인한다. 로그 mtime과 메타의 활동 시각 일치가 교차검증 포인트다.
• log: (로그 파일 없음): 원격(웹) 세션이거나 로그가 정리됐거나 cwd가 옮겨진 경우. claude는 ~/.claude/projects/*/.jsonl로 재수색한다.
• 이름 검색이 안 되면 내용으로 기억하는 것이다: claude는 search_session_transcripts MCP(나온 local_ ID를 --id로 역조회), codex/aside는 로그 디렉터리 grep -rl.
• 이미지 추출(session-image-extract)은 claude 로그 형식 기준이다. codex는 이미지가 event_msg/response_item의 data URI로, aside는 세션 폴더 artifacts/에 있다.

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.