dsh-context-compass: A Session Health Indicator for Real Data

dsh-context-compass is a session-health plugin for DeepSeek Harness. It reads real runtime data (such as tokenMeter and Git status) to provide quantitative evidence, helping developers decide whether to continue the current session or start a new one. Core features include a reactive badge next to the session log (showing pressure trends, cost, and compression information), the `/compass` command (which provides a detailed text report), and a multi-session compass overview panel. The plugin uses a "continue vs. switch" decision model with four default status levels: green, blue, yellow, and red, and supports adjusting thresholds and toggling probes through configuration. It also includes built-in official pricing parsing, dual-currency display, and peak/off-peak pricing, aiming to enable data-driven management of the session lifecycle.

Read More