deepwork-tracker

v2026.09.24

Track deep work sessions locally (start/stop/status) and generate a GitHub-contribution-graph style minutes-per-day heatmap for sharing (e.g., via Telegram). Use when the user says things like “start deep work”, “stop deep work”, “am I in a session?”, “show my deep work graph”, or asks to review deep work history.

GitHub
Install command
npx skhub add sundial-org/deepwork-tracker
Markdown
SKILL.md

Deepwork Tracker

Use the local deepwork app (SQLite-backed) at ~/clawd/deepwork/deepwork.js.

Bootstrap (if the script is missing)

If ~/clawd/deepwork/deepwork.js does not exist, bootstrap it from the public repo:

mkdir -p ~/clawd
cd ~/clawd

# Clone if missing
[ -d ~/clawd/deepwork-tracker/.git ] || git clone https://github.com/adunne09/deepwork-tracker.git ~/clawd/deepwork-tracker

# Ensure expected runtime path exists
mkdir -p ~/clawd/deepwork
cp -f ~/clawd/deepwork-tracker/app/deepwork.js ~/clawd/deepwork/deepwork.js
chmod +x ~/clawd/deepwork/deepwork.js

(Do not fail the user request if clone/copy fails—still attempt other steps and report what’s missing.)

Commands

Run via exec:

  • Start a session (also starts a macOS Clock timer; default target 60m):
    • ~/clawd/deepwork/deepwork.js start --target-min 60
  • Stop a session:
    • ~/clawd/deepwork/deepwork.js stop
  • Check status:
    • ~/clawd/deepwork/deepwork.js status
  • Generate a report:
    • Last 7 days (default): ~/clawd/deepwork/deepwork.js report --days 7 --format text
    • Telegram-ready last 7 days: ~/clawd/deepwork/deepwork.js report --days 7 --format telegram
    • Heatmap (optional): ~/clawd/deepwork/deepwork.js report --mode heatmap --weeks 52 --format telegram

Chat workflows

Start deep work

  1. Run ~/clawd/deepwork/deepwork.js start --target-min 60 (or another target if the user specifies it).
  2. This should also start a macOS Clock timer for the target duration (best-effort; may require Accessibility permissions).
  3. Reply with the confirmation line.

Stop deep work

  1. Run ~/clawd/deepwork/deepwork.js stop.
  2. Reply with duration.

Show deep work graph

  1. Run ~/clawd/deepwork/deepwork.js report --days 7 --format telegram.
  2. Always send the output to Alex on Telegram (id 8551040296) using the message tool with a Markdown monospace code block.
  3. Optionally acknowledge in the current chat that it was sent.

If the user wants different ranges, support --days 7|14|30|60. (Heatmap is still available via --mode heatmap --weeks ... when explicitly requested.)

Discovery
Tags

No tags published for this skill.

Version
Latest version metadata

Version

v2026.09.24

Published

Sep 24, 2026

Category

Uncategorized

License

Not specified

Source path

skills/deepwork-tracker

Default branch

main

Latest commit

b80cde2

Tree SHA

fc3a971