alivesession-history

# History Session timeline and recent activity. The system's short-term memory. Not a search (that's find — searches content across walnuts). History searches SESSIONS — what squirrels did, what was discussed, what was decided. For deep context extraction from source material, use `alive:mine-for-context`. --- ## How It Works Two tiers of data. Always start with tier 1. Go to tier 2 via revive. **Tier 1 — Squirrel Entries** (`.alive/_squirrels/*.yaml`, with fallback to per-walnut `_kernel/_squirrels/*.yaml`) Structured, fast, indexed. Session ID, walnut, model, timestamps, stash items, transcript path. Every squirrel leaves one of these. **Tier 2 — Session Transcripts** (path stored in squirrel YAML `transcript:`) The full conversation. Every message, every agent response, every tool call, every result. This is the deep context — the actual thinking, the back-and-forth, the nuance that didn't make it into the stash. --- ## Modes ### Browse (no args) Show recent sessions across all walnuts. **Default filter:** only show sessions with `saves > 0` or non-empty stash. Cap at 10 results. Add a summary line: "N empty shells not shown." Use `history --shells` to include them. **Data source:** prefer `.alive/_index.yaml` `recent_sessions:` as primary data. Fall back to direct `.alive/_squirrels/` YAML walk only if the index is missing or returns fewer results than requested. ``` ╭─ squirrel history — recent sessions │ │ 1. 2a8c95e9 nova-station today opus-4-...