π dsh-calendar
August 21, 2026 Β· View on GitHub
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 | δΈζ
Screenshots
Four time perspectives of your DeepSeek usage β light and dark both follow DSH.
ποΈ Year & ποΈ Month
 Year |
 Month |
π 7-day view
 π Dark |
 βοΈ Light |
β±οΈ Day view
 π Dark |
 βοΈ Light |
π Main-UI cards
 7-day |
 Day Β· π Dark |
 Day Β· βοΈ Light |
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 heatmap | GitHub-style 52Γ7 contribution map β spot your busiest seasons at a glance |
| π 7-day timeline | Seven columns, one day each, a vertical 24-hour timeline. Every session keeps its own color, so you can trace one task across days |
| β±οΈ Day timeline | 24-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 grid | Classic calendar with per-day heat bars and totals |
| π Main-UI cards | Draggable 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 headers | Timeline rows carry a folder icon, a glowing accent bar, and a pill badge with session count + active time β at a glance, per workspace |
| π±οΈ Drill through | Click any timeline bar to open the actual conversation |
| π Stats strip | Active time / sessions / turns / tool calls / tokens for the selected range, with count-up numbers |
| πͺ Token usage | Billed token accounting per day / session / workspace β exact when the provider reports usage, heuristically estimated otherwise |
| π¨ Theme-aware | Follows the harness theme β light and dark, automatically; bars and heat use the real brand blue in both themes |
| β¨ Animations | Gentle entry effects and a decrypt-reveal headline β nothing janky, nothing in the way |
| π History, out of the box | Past sessions are folded and cached at startup β last month's activity is visible without opening anything |
Compatibility
| dsh-usage-calendar | DeepSeek Harness |
|---|---|
| 0.1.4 | 0.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.3 | 0.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
Wrappedreport + shareable PNG export - Workspace filtering and session search
- iCal export of DeepSeek's active windows