Absolute path to the project directory under ~/.claude/projects/<slug>/
Array of session UUIDs (without .jsonl extension), in directory order.
const dir = '/Users/me/.claude/projects/-Users-me-my-project';
// Sequential — memory-bounded, one session at a time
for (const id of await readSessionIds(dir)) {
const session = await readSession(dir, id);
// process and discard
}
// Parallel — caller picks the strategy (Promise.all, p-limit, …)
const ids = await readSessionIds(dir);
const sessions = await Promise.all(ids.map((id) => readSession(dir, id)));
Reads session IDs from a project directory.
Scans top-level
*.jsonlfiles and returns their UUIDs (filename without extension). Excludes legacyagent-*.jsonlinline subagent files (CC < 2.1.2). Returns an empty array if the directory does not exist.Pair with readSession or readSessionTurns to walk a project.