Skip to content
BENIBIX Learn

Session Transcript

AI⌨️ Claude CodeClaude Code Concepts

Also known as Transcript, Session JSONL file, Claude Code transcript

The file on disk where Claude Code keeps a session.

Think of it like

It is like the notes from a meeting, kept in a drawer.

Example

Jack wants to know which command broke his build. He opens the session transcript and finds the exact Bash call and its output.

Why it matters

It is the true record of what Claude did, which helps when you need to check or explain a change.

Definition

A session transcript is the file where Claude Code keeps a session. By default it lives at ~/.claude/projects/, in a folder for the project, as one file per session. Each message and tool call is one line of JSON in it. Claude Code reads the file back when you resume, which is how a conversation goes on after you close it. You can also read it yourself to see exactly what happened.

Example code

bash
ls ~/.claude/projects/
List the saved projects and their sessions.
Each message becomes one line in the session's file.

Common mistake

Pasting a transcript to someone without reading it. It can hold file contents, keys or other private text from the session.

Key takeaways

  1. 1
    A file per session. Under ~/.claude/projects/.
  2. 2
    One line per step. JSON.
  3. 3
    Read to resume. And to check.

Learn it properly