dsh-todo-float-ball

When an AI agent in DeepSeek Harness tackles a multi-step task, its plan lives in a small strip above the input box. Scroll a little and it is gone; the agent is still working but the strip has already collapsed. dsh-todo-float-ball mirrors that checklist onto a persistent, draggable floating ball fixed to a corner of your window. The ball face shows live done/total and the active task name; its color tells you the state at a glance—pulsing orange for in-progress, green for all done, blue for pending-only, gray for no list. Click it and a full task panel unfolds right beside the ball.

Under the hood, two independent channels keep the data fresh: a debounced MutationObserver watches the official panel DOM, while a passive listener on session-projection frames catches the structured todo payload. Both funnel into one normalizer, so the complete list is available even when the official strip is collapsed. New snapshots merge into older ones rather than wiping them out, creating a foldable history archive with per-row hide, batch cleanup, one-click restore, and pinned-session parity. All UI lives inside an open Shadow DOM with all:initial, making it immune to theme and skin plugins. The same codebase runs in DSH Desktop (Electron) and the browser.

If you regularly ask an agent in DSH to execute ten-plus-step plans and do not want to keep scrolling back up to check on progress, this floating ball is built for you. It is pure, read-only, zero-telemetry, and touches nothing else—no modifications to the official panel, the conversation, or any other plugin.