Introduction

DeepSeek Harness users often manage many sessions, background tasks, and scheduled reminders, but it can be difficult to see this work: when it ran, how long it lasted, or when the next recurring task will trigger. dsh-calendar turns existing usage history into a clean calendar view.

What is this

dsh-calendar is a DeepSeek Harness client plugin, maintained by YLifeOnlyOnce and released under the MIT license. It provides day, 7-day, month, and year views to visualize DeepSeek operations. The plugin is zero-configuration, requires no extra data storage, and folds and caches history at startup.

Core Features

The plugin provides multiple views and interaction modes:

  • Timeline views: Provides a 7-day timeline (seven columns, one column per day, with a vertical 24-hour axis) and a day timeline (24-hour Gantt axis, grouped by workspace → session).
  • Heat maps and grids: Annual heat map (GitHub-style 52×7 contribution chart) and monthly grid (classic calendar with daily heat bars and totals).
  • Workspace headers: Timeline rows include a folder icon, a glowing accent bar, and a pill badge showing session count and active time.
  • Interaction and navigation: Clicking a timeline bar opens the actual conversation; hovering over any cell or entry shows the time window, duration, and turn count.
  • Draggable cards: The main UI cards (statistics, year, 7-day, day, month) float over the main interface. Drag the ⠿ handle to move them, use ▾ to collapse, and use × to close.
  • Statistics and tracking: The statistics bar displays active time, sessions, turns, tool calls, and tokens. Token usage is accounted by day, session, or workspace.
  • Theme and animation: Follows the Harness theme (light/dark), with gentle entrance effects and a decoded title reveal.

Installation and Activation

  1. Run the installation command:
    dsh plugin --profile web add dsh-usage-calendar
  1. Restart dsh web.
  2. Open Settings → 📅 Calendar.

Typical Usage

  • View switching: Use ‹ › and Today to switch between day, 7-day, month, and year views.
  • Quick jumping: Click a heat map cell, monthly cell, or timeline bar to jump to a specific date or conversation.
  • Card management: Drag a card handle to adjust its position, use ▾ to collapse a panel, and use × to remove a card.
  • Information viewing: Hover over any cell or entry to view the specific time window, duration, and turn count.

Compatibility and Notes

  • Version requirements: Requires DeepSeek Harness 0.1.1-rc.1 (next) or 0.1.0-rc.7.
  • Zero maintenance: No configuration or extra data storage is required; the plugin runs with the current Harness process permissions.
  • Preview capability: Visual effects can be previewed through the demo page without running Harness.

Summary

dsh-calendar gives DSH users a way to visualize and track usage patterns, turning raw logs into intuitive timelines and calendars. For the source code and repository, visit the provided GitHub link.