dsh-handoff

When a session ends or context shifts, verbal handoffs and scattered notes tend to drop critical details. dsh-handoff freezes the current session—goals, completed and pending items, key files, and statistics—into a single structured Markdown document, giving the next person or the next session an immediate, readable picture of the full state without sifting through raw chat logs.

It pulls facts directly from the DSH session event stream: user messages, tool call results, todo states, goal/change entries, and token counts. No LLM is invoked, no model inference is performed, and identical input always yields identical output. The generated document contains seven sections—Session Handoff, Goals, Completed, Pending, Next Steps, Key Files, and Session Stats. If the event structure is unavailable, it degrades gracefully to a skeleton template with an explanation rather than throwing an error; write paths are strictly fenced to the workspace root.

Ideal for developers who frequently switch project contexts, collaborate in relay-style development, or need a written record after a long session. Zero dependencies, pure ESM, no build step—install and go.