Session captures

While your session is open, fai captures everything: AI conversations, file changes, terminal commands, git events. All written to disk immediately as JSONL files - zero AI calls, zero cost.

You don't see this happening. You just work.

What it captures

  • AI transcripts - every message to and from your AI
  • File changes - which files changed and when
  • Terminal activity - commands you ran
  • Git events - commits, branches, merges

How it's scoped

Session captures are scoped to the branch named journal/<session-name> inside your workbench's git repository. Everything captured while that branch is active belongs to this session.

When it closes

When you seal the session, the capture branch merges into pending. The raw captures are then available for synthesis.

What it produces

Timestamped JSONL files grouped by type (suffix). These become digest files that synthesis agents read when a knowledge cascade runs.

How it relates to other vaults

Session captures are temporary working storage. They feed the project vault (and personal vault) through the synthesis pipeline - but don't survive as session captures after synthesis runs. The synthesized knowledge lives in the project and personal vaults permanently.

On this page