dsh-token-pet

When you run long sessions in DSH, it is often hard to tell at a glance whether a request is still in flight, how close the context window is to its limit, or whether a tool call just succeeded or failed. dsh-token-pet distils all of those signals into a small chibi character that lives on your desktop: twelve frame-by-frame animations map one-to-one to real DSH events such as idle, working, context compression, tool success, tool failure, and prompt generation, so a quick look at the status badge and the context-percentage label tells you what the system is doing right now without switching to a log window.

A draggable, resizable three-tab panel sits beside the pet. The Overview tab shows current round, step count, model latency, and token breakdown; the Models tab aggregates per-provider and per-model usage with a local-timezone hourly trend chart; and a cross-session Lifetime Ledger keeps cumulative totals even after the source conversation is archived or deleted. The panel reads only persisted snapshots, so opening it never triggers a full history scan; background incremental indexing is coordinated by the host at low frequency with a ten-second deadline fallback, keeping the UI lightweight throughout. A prompt-enhancement drawer lets you trigger, preview, edit, overwrite, append, undo, or submit the result directly to the DSH composer entirely on your terms.

If you develop with DSH daily and care about token spend and context health, or if you simply want a little character on your desktop that makes system state visible at a glance, dsh-token-pet was built for that.