dsh-session-health

When an agent keeps working inside a single session, context balloons, compressions accumulate, and tool calls stack up. Quality degrades slowly and silently. dsh-session-health turns that vague feeling of it is time to hand off into a quantified, real-time report. A small draggable button in the corner reveals context occupancy, compression count, token spend, and per-round call trends on demand, so you judge session state with data instead of instinct.

The core is a 0-100 score weighted across three factors (context 40%, compressions 30%, cache-hit ratio 30%), mapped to four tiers. Once the score dips into sub-healthy range, a one-click Generate handoff and restart button appears. It injects a summary prompt into the current conversation; the agent writes the handoff file and returns its path, giving you a clean relay point for a fresh session. Line charts, a red-green context bar, per-tool token and duration rankings, and a reverse-ordered step log make every bottleneck visible at a glance.

Built for anyone running long-horizon agent workflows, multi-step tool pipelines, or human-in-the-loop loops inside DeepSeek Harness. If you have felt a session getting heavy but could not articulate why, this plugin puts the evidence in front of you and makes the handoff low-cost and well-grounded.