Updated Edit
On this page
Extract a git repository's activity over a time window and render a Markdown journal, optionally narrated by an LLM.
#reposummary summarize
Extract a git repository's activity over a time window and render a Markdown journal, optionally narrated by an LLM.
Effect: mutating
#Flags
| Name | Short | Type | Presence | Env | Description |
|---|---|---|---|---|---|
--window | str | required | time window: today | yesterday | week | month | all | | ||
--synthesis | str | required | LLM synthesis backend for the prose summary: none, claude-cli, or anthropic-api (no silent fallback) Values: none (no LLM; the journal is the deterministic extraction only), claude-cli (shell out to the local claude CLI (no API key needed)), anthropic-api (call the Anthropic Messages API (requires ANTHROPIC_API_KEY)). | ||
--model | str | optional | model id for LLM synthesis (e.g. haiku); used only when --synthesis is claude-cli or anthropic-api; omitted means haiku | ||
--branch | str | optional | git ref to treat as the tip of history when resolving the window; omitted means HEAD | ||
--output | str | optional | write the generated Markdown journal to this file; omitted prints it to standard output | ||
--cache-dir | str | optional | directory for the on-disk journal cache; omitted means the user cache dir | ||
--cache, --no-cache | bool | optional | use the on-disk journal cache; pass --no-cache to always recompute the journal from scratch; omitted means the cache is used |
#Arguments
| Name | Type | Presence | Description |
|---|---|---|---|
repo | str | optional | path to the git repository to summarize (a normal checkout or a bare + worktree layout); omitted means the current directory |