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.
Best use case
deepwork-tracker is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
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.
Teams using deepwork-tracker should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/deepwork-tracker/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How deepwork-tracker Compares
| Feature / Agent | deepwork-tracker | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
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.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# 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: ```bash 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.)
Related Skills
opentwitter
Twitter/X data via the 6551 API. Supports user profiles, tweet search, user tweets, follower events, deleted tweets, and KOL followers.
opennews
Crypto news search, AI ratings, trading signals, and real-time updates via the OpenNews 6551 API. Supports keyword search, coin filtering, source filtering, AI score ranking, and WebSocket live feeds.
agent-reach
Give your AI agent eyes to see the entire internet. Read and search across Twitter/X, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu, Instagram, LinkedIn, Boss直聘, RSS, and any web page — all from a single CLI. Use when: (1) reading content from URLs (tweets, Reddit posts, articles, videos), (2) searching across platforms (web, Twitter, Reddit, GitHub, YouTube, Bilibili, XiaoHongShu, Instagram, LinkedIn, Boss直聘), (3) user asks to configure/enable a platform channel, (4) checking channel health or updating Agent Reach. Triggers: "search Twitter/Reddit/YouTube", "read this URL", "find posts about", "搜索", "读取", "查一下", "看看这个链接", "帮我配", "帮我添加", "帮我安装".
searxng-search
使用自建SearXNG搜索引擎搜索互联网内容。触发词：搜索、查一下、帮我查、查找、搜一下、帮我搜索。
multi-search-engine
Multi search engine integration with 17 engines (8 CN + 9 Global). Supports advanced search operators, time filters, site search, privacy engines, and WolframAlpha knowledge queries. No API keys required.
weather
Get current weather and forecasts via wttr.in or Open-Meteo. Use when: user asks about weather, temperature, or forecasts for any location. NOT for: historical weather data, severe weather alerts, or detailed meteorological analysis. No API key needed.
wacli
Send WhatsApp messages to other people or search/sync WhatsApp history via the wacli CLI (not for normal user chats).
voice-call
Start voice calls via the OpenClaw voice-call plugin.
video-frames
Extract frames or short clips from videos using ffmpeg.
trello
Manage Trello boards, lists, and cards via the Trello REST API.
tmux
Remote-control tmux sessions for interactive CLIs by sending keystrokes and scraping pane output.
things-mac
Manage Things 3 via the `things` CLI on macOS (add/update projects+todos via URL scheme; read/search/list from the local Things database). Use when a user asks OpenClaw to add a task to Things, list inbox/today/upcoming, search tasks, or inspect projects/areas/tags.