deepwork-tracker/SKILL.md

name, description

name	description
deepwork-tracker	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.

Deepwork Tracker

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

Bootstrap (if the script is missing)

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

mkdir -p ~/bot
cd ~/bot

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

# Ensure expected runtime path exists
mkdir -p ~/bot/deepwork
cp -f ~/bot/deepwork-tracker/app/deepwork.js ~/bot/deepwork/deepwork.js
chmod +x ~/bot/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):
  • ~/bot/deepwork/deepwork.js start --target-min 60
• Stop a session:
  • ~/bot/deepwork/deepwork.js stop
• Check status:
  • ~/bot/deepwork/deepwork.js status
• Generate a report:
  • Last 7 days (default): ~/bot/deepwork/deepwork.js report --days 7 --format text
  • Telegram-ready last 7 days: ~/bot/deepwork/deepwork.js report --days 7 --format telegram
  • Heatmap (optional): ~/bot/deepwork/deepwork.js report --mode heatmap --weeks 52 --format telegram

Chat workflows

Start deep work

1. Run ~/bot/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 ~/bot/deepwork/deepwork.js stop.
2. Reply with duration.

Show deep work graph

1. Run ~/bot/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.)