claude-nova/docs/features/session-history.md

Session history

Status: Implemented · Code: Scripts/sessions-store.js

Resume Session… lists this project's previous Claude Code sessions — including ones started in a terminal — without shelling out to the interactive picker.

Where Claude Code stores sessions

~/.claude/projects/<slug>/<session-id>.jsonl

The slug is the project path with / and . flattened to -:

/Users/me/Developer/git.example.ca/thing.novaextension
→ -Users-me-Developer-git-example-ca-thing-novaextension

projectSlug() implements exactly that substitution. Files are sorted by mtime, newest first.

Labels

firstPrompt() reads up to 40 lines of a transcript looking for the first non-meta, non-synthetic user message and uses it as the picker label, falling back to the short session id.

Resuming

--resume <id> replaces --session-id. The session model is reset and rebuilt from the resumed session's messages as they stream in.

Gotchas

• Transcripts can be megabytes; firstPrompt() uses readline() and stops early rather than reading whole files.
• Zero-byte and non-.jsonl entries are skipped.