Search docs

Jump to a BRB documentation page

Continuity

Resume work and recover safely without rereading everything

BRB stores structured project memory, ranks the most relevant notes for the next session, and creates restore points so an agent can continue or roll back with confidence.

Core concepts
https://docs.brbgit.com/resume-and-recovery

Structured memory

  • Instructions, handoff notes, continuity notes, decisions, and summary documents are stored per repo.
  • Conversation consolidation distills longer sessions into smaller continuity artifacts.
  • Resume ranking weighs user asks, changed files, latest commits, and checkpoints together.

Resume workspace

  • The dashboard Resume action opens a focused handoff view.
  • That view packages the recommended start, current sync state, latest commit, latest message, restore point, and top continuity notes.
  • A shorter supporting activity timeline appears beneath it instead of the full project feed.

Handoff export

Resume mode can copy a markdown handoff to the clipboard or download it as a file for another agent or tool.

Restore points

  • A restore point is created after synced commits.
  • Restoring creates a new commit that re-applies the selected snapshot instead of mutating history invisibly.
  • If brb watch or the daemon is running, BRB also applies that restored snapshot back to the local working tree automatically.
  • BRB refuses to overwrite local unsynced changes. If the local repo is dirty, restore waits until the repo is clean again.
  • The UI surfaces the latest restore point directly and lets the user restore from there.