SDKSession storage

Session storage

Syntic Code keeps each session as a transcript file on your computer.

Where transcripts live

Transcripts are kept in the application data folder, in one folder per project. On macOS the default is ~/Library/Application Support/ai.syntic.syntic/projects/. Sessions are grouped by the folder where the session started, so the same repository opened from two folders has two groups.

Set SYNTIC_DATA_DIR to move the whole application data folder somewhere else. Transcript folders are readable only by your user.

What a transcript holds

  • The messages of the session and the tool results.
  • The files the session read, with the state needed to refuse edits to files that changed since the read.
  • File snapshots used by /rewind.
  • The cost and model metadata recorded for the session.

Finding a session

  • syntic --resume lists sessions in the current project. --all-projects widens the list to every project.
  • A session is named by its id. Its title (generated from the first prompt, or set with /rename or --name) can also be passed to --resume when it is unique.

Removing transcripts

Nothing is deleted unless you set cleanupPeriodDays. With it set to a whole number of days (at least 1), saved sessions untouched for longer than that are removed shortly after start-up, in the background, at most once a day. The session being resumed is never removed. A value such as 0 is reported and nothing is deleted. You can also delete transcript files in the project folder by hand.

See Sessions for resume and fork flags.