# Session Id Lookup

> 세션 이름으로 원본 세션 ID와 대화 로그 경로를 찾는다. Claude Code(사이드바 제목), Codex(스레드 이름·첫 프롬프트), Aside(세션 제목) 세 에이전트를 모두 지원한다. "원본 세션 id 찾아줘", "세션 ID 뭐야", "사이드바에 있는 그 세션", "코덱스 세션 찾아줘", "codex rollout 파일 어디", "aside 세션 로그", "resume할 ID", "이 ID가 무슨 세션이야?" 같은 말이 나오면 이 스킬을 쓴다. session-image-extract로 특정 세션의 이미지를 꺼내거나 claude --resume / codex resume 할 세션을 지목해야 하는데 사용자가 세션을 이름으로만 기억할 때 먼저 트리거한다. list_sessions MCP 도구가 주는 lo…

- **Type:** Skill
- **Install:** `agentstack add skill-tygb99-claude-code-session-skills-session-id-lookup`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Tygb99](https://agentstack.voostack.com/s/tygb99)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Tygb99](https://github.com/Tygb99)
- **Source:** https://github.com/Tygb99/claude-code-session-skills/tree/main/session-id-lookup

## Install

```sh
agentstack add skill-tygb99-claude-code-session-skills-session-id-lookup
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

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

## 조회 도구

```bash
# 통합 검색 (세 에이전트 전부, 이름 부분일치 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](https://github.com/Tygb99)
- **Source:** [Tygb99/claude-code-session-skills](https://github.com/Tygb99/claude-code-session-skills)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-tygb99-claude-code-session-skills-session-id-lookup
- Seller: https://agentstack.voostack.com/s/tygb99
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.