Claude Code Projects
Claude Code Projects
Every time you run claude in a directory it will create a Claude Code Project, stored under ~/.claude/projects. Project names are based on the folder location (e.g. -home-andrew-Sites-grocery-share-price-monitoring).
cd -- <project-name>to cd into the project folder under~/.claude/projects.- Each session of a project is stored as a
.json/.jsonlfile. The name of the file is thesession_id. - Memory is stored in the project as well (a
memorysubfolder).
Session JSONL record types include:
- File history snapshot:
{type: "file-history-snapshot", messageId, snapshot: {messageId, trackedFileBackups, timestamp}, isSnapshotUpdate} - User message:
{type: "user", uuid, parentUuid, isSidechain, timestamp, userType, cwd, sessionId, version, gitBranch, message: {role, content}, isMeta} - System command:
{type: "system", subtype: "local_command", content, level: "info|warning|error", timestamp, uuid, isMeta, userType, cwd, sessionId, version, gitBranch}
Related: Session, Auto Memory