Sessions & History

Session continuity, export, resume, abort, and cleanup.

Sessions preserve conversation continuity. Transcripts, compaction summaries, artifacts, cost, and replay data are persisted in a local SQLite database, and each agent gets its own workspace folder.

Managing sessions

budgetai sessions list
budgetai sessions show <id>
budgetai sessions resume <id>
budgetai sessions export <id> --format md
budgetai sessions abort <id>
budgetai sessions delete <id>

What is stored

DataPurpose
TranscriptFull turn-by-turn history
SummariesCompaction of older context
ArtifactsGenerated files and media
CostPer-turn and per-session receipts
ReplayRead-only reconstruction of a turn

Continuity

Long sessions compact old context while preserving recent task state, keeping prompts focused and prompt-cache reuse high. See Compaction & Cache.