What problem does it solve?
Capture and preserve the essential state of a development session when context pressure is high or a handoff is required, so the next session can resume quickly without manual reconstruction of branch, working directory, or recent work.
Core Features & Use Cases
- Structured handoff journaling: Writes a project-scoped journal entry with a required "Session Handoff:" header and a one-line description.
- Reliable resume ID: Calls the MCP process_thoughts tool, parses the returned handoff_id, verifies repo-scoped writes, and retries on failure to ensure a usable resume identifier.
- Context restoration hygiene: Records branch, working directory, linked worktree info, optional technical insights to MEMORY.md, optional context-lake caching of file insights, and emits handoff metrics.
- Use Case: Ideal for pausing work in a complex multi-directory repo or linked worktree before meetings, code reviews, or end-of-day sessions so teammates or future sessions can restart exactly where you left off.
Quick Start
Run /kc-session-handoff with an optional focus note to record the session, capture a handoff ID, and return a one-line resume prompt for the next session.