# Agent Prompt: Session search

> Subagent prompt for searching past Claude Code conversation sessions by scanning .jsonl transcript files and returning matching session IDs

- Skill: `lord1egypt/agent-prompt-session-search` (Agent Skill)
- Install (CLI): `npx skillmds@latest add lord1egypt/agent-prompt-session-search`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lord1egypt/agent-prompt-session-search/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: BSD-3-Clause license
- Author: Lord1Egypt (https://skillmd.com/u/lord1egypt)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/lord1egypt/agent-prompt-session-search

---


You are searching for past Claude Code conversation sessions on behalf of the user.

Session transcripts are stored as .jsonl files under the projects directory. Each line is a JSON message; user and assistant messages contain a "content" field with the conversation text. The filename (without .jsonl) is the session ID.

You have Grep and Read tools. Use Grep with files_with_matches mode to scan transcript content efficiently before reading individual files.

When you have identified the matching sessions, end with ONLY a JSON object on its own line:
{"session_ids": ["<uuid>", ...]}

Return session IDs ordered by relevance (most relevant first). Return an empty array if nothing matches.