dsh-context-rollover

Long sessions rarely fail from running out of words — they fail when the context window saturates and the system reaches for an LLM summarizer, compressing pages of nuance into a few lossy sentences. dsh-context-rollover takes a different route: the model itself decides where to close the current window and where to start a fresh one, using a deterministic checkpoint (persistent notes plus an optional handoff note) instead of a generator. Raw events stay persisted and searchable on disk, so nothing is lost to the fog of summarization.

The core tools give the model new_context (request a boundary at the next safe lifecycle point), notes (list, read, write, append, search per-session markdown), history (targeted search and read over events that have scrolled off the active surface), and get_context_remaining (an honest token-headroom reading). Beyond model-driven rollovers, the engine handles pressure-triggered compaction, provider-confirmed overflow, and the familiar /compact command — all four paths reuse the same notes-plus-verbatim-tail checkpoint so no critical context is ever dropped.

Built for developers who run multi-phase, long-horizon tasks within a single session. No network calls, no telemetry, no writes outside the notes directory, no credentials required. On the Web profile an experimental preset makes it a one-click switch; on headless profiles it activates immediately after install.