DeepSeek Harness plugin

dsh-calendar-ylifeonl

A beautiful usage calendar for DeepSeek Harness — see at a glance when and what DeepSeek did, in day/month/year views, with recurring-task scheduling.

Jump to install

Source facts

Repository
YLifeOnlyOnce/dsh-calendar
Latest update
Aug 21, 2026
Category
Tools & Capabilities
GitHub stars
1
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/YLifeOnlyOnce/dsh-calendar
Plugin: dsh-calendar-ylifeonl
Author: YLifeOnlyOnce

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer4 files
README.mdSource · read only
README language

📅 dsh-calendar

> See at a glance what DeepSeek did, and when. A beautiful, theme-aware usage calendar for DeepSeek Harness — every project and task's execution time, in day / 7-day / month / year views.

English | 中文

![npm version](https://www.npmjs.com/package/dsh-usage-calendar) ![License](LICENSE)

![dsh-calendar banner](docs/screenshots/banner.png)

---

Screenshots

Four time perspectives of your DeepSeek usage — light and dark both follow DSH.

🗓️ Year & 🗂️ Month

<table align="center"> <tr> <td align="center"><img src="docs/screenshots/logs-year.png" width="175" alt="Year view (dark)"/><br/><b>Year</b></td> <td align="center"><img src="docs/screenshots/logs-month.png" width="175" alt="Month view (dark)"/><br/><b>Month</b></td> </tr> </table>

📅 7-day view

<table align="center"> <tr> <td align="center"><img src="docs/screenshots/logs-7days-dark.png" width="175" alt="7-day view (dark)"/><br/><b>🌙 Dark</b></td> <td align="center"><img src="docs/screenshots/logs-7days-light.png" width="175" alt="7-day view (light)"/><br/><b>☀️ Light</b></td> </tr> </table>

⏱️ Day view

<table align="center"> <tr> <td align="center"><img src="docs/screenshots/logs-day-dark.png" width="175" alt="Day view (dark)"/><br/><b>🌙 Dark</b></td> <td align="center"><img src="docs/screenshots/logs-day-light.png" width="175" alt="Day view (light)"/><br/><b>☀️ Light</b></td> </tr> </table>

🃏 Main-UI cards

<table align="center"> <tr> <td align="center"><img src="docs/screenshots/card-7days.png" width="280" alt="Main-UI card 7-day"/><br/><b>7-day</b></td> <td align="center"><img src="docs/screenshots/card-day-dark.png" width="280" alt="Main-UI card day (dark)"/><br/><b>Day · 🌙 Dark</b></td> <td align="center"><img src="docs/screenshots/card-day-light.png" width="280" alt="Main-UI card day (light)"/><br/><b>Day · ☀️ Light</b></td> </tr> </table>

---

Why

You use DeepSeek Harness every day — dozens of sessions, background jobs, scheduled reminders. But there was never a way to see the work: when each project ran, for how long, how much tool activity happened, or when the next recurring task fires.

dsh-calendar turns your existing usage history into a beautiful calendar — zero configuration, no extra data store, nothing to maintain. Install, restart, open Settings → 📅 Calendar, and your entire history is there.

Features

🗓️ Year heatmapGitHub-style 52×7 contribution map — spot your busiest seasons at a glance
📅 7-day timelineSeven columns, one day each, a vertical 24-hour timeline. Every session keeps its own color, so you can trace one task across days
⏱️ Day timeline24-hour Gantt axis by workspace → session. Turns merge into task segments — one user prompt opens a task, the work that follows joins it, one bar per task
🗂️ Month gridClassic calendar with per-day heat bars and totals
🃏 Main-UI cardsDraggable mini cards (stats / year / 7-day / day / month) float over the main interface — move, collapse, or close them; pick which ones show in Settings. Frosted translucent cards with soft shadows, so they sit lightly on top of your work
🏷️ Workspace headersTimeline rows carry a folder icon, a glowing accent bar, and a pill badge with session count + active time — at a glance, per workspace
🖱️ Drill throughClick any timeline bar to open the actual conversation
📊 Stats stripActive time / sessions / turns / tool calls / tokens for the selected range, with count-up numbers
🪙 Token usageBilled token accounting per day / session / workspace — exact when the provider reports usage, heuristically estimated otherwise
🎨 Theme-awareFollows the harness theme — light and dark, automatically; bars and heat use the real brand blue in both themes
AnimationsGentle entry effects and a decrypt-reveal headline — nothing janky, nothing in the way
🕐 History, out of the boxPast sessions are folded and cached at startup — last month's activity is visible without opening anything

Compatibility

dsh-usage-calendarDeepSeek Harness
0.1.40.1.1-rc.1 (next) — adapted to the session-projection stateSchema / wire unit contract; @deepseek-ai/dsh-client-web-react removed (merged upstream)
0.1.0 – 0.1.30.1.0-rc.7

Install

dsh plugin --profile web add dsh-usage-calendar

Restart dsh web, then open Settings → 📅 Calendar.

Usage

  • Views — switch Day / 7-day / Month / Year with one click; ‹ › steps, Today jumps back.
  • Drill through — click a heatmap cell, a month cell, or a timeline bar to jump into that day or conversation.
  • Main-UI cards — drag the ⠿ handle anywhere, collapse , close ×; re-enable in Settings → Calendar → Main-UI cards.
  • Hover — any cell or bar shows the exact window, duration, and turn count.
  • Live — running sessions pulse, and today's day view draws a live now-line.

Demo preview

▶️ Live demo: open the showcase page — hero banner, four views, and the main-UI cards, ready to screenshot.

No live harness needed to preview the visuals locally either — the repo ships a demo page with rich sample data (dark/light switchable):

pnpm demo:build && open docs/demo.html

Roadmap

  • Recurring-reminder panel (upcoming / overdue / fired history) with ⏰ markers on the timelines
  • Yearly Wrapped report + shareable PNG export
  • Workspace filtering and session search
  • iCal export of DeepSeek's active windows

License

[MIT](LICENSE)