session_brief tool

Tool: session_brief

Get a compact summary of what happened in past session(s) on this repo — facts remembered, content stashed, files reindexed. Use this to catch up before starting work, instead of re-deriving context from scratch.

Arguments Schema

Parameter	Type	Required	Description
repo_path	string	Required	Absolute path to the workspace root.
scope	string	Optional	Scope: "last" (default, since last session boundary), "today", "all".
budget	string	Optional	Token budget (default 300). Events are oldest-first within scope.
sessions	string	Optional	Number of past sessions to return (e.g. "5" for last 5). Overrides scope.

Tool Input JSONRequest

{
  "repo_path": "/path/to/repo",
  "scope": "last",
  "budget": "300"
}

Tool Response JSONResponse

=== Session Brief (last session) ===
Remembered facts:
  auth-entrypoint: "Auth starts in server/auth.go Login()."
Stashed content:
  ci-build-log (handle: a1b2c3, ~18k tokens)
Files reindexed: 0

Developer Best Practices

Call this at the start of a new session to catch up on context without re-reading earlier conversations.
Use the scope or sessions parameter to control how far back to look.