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.