deepwork-tracker

What This Skill Does

The deepwork-tracker is a sophisticated productivity utility designed to manage focus sessions using a local SQLite-backed tracking system. It acts as an orchestrator for your deep work habits, allowing you to track time spent on tasks, monitor session status, and generate visual data representations such as contribution heatmaps. By integrating directly with your local system, it ensures that your productivity data remains private and easily accessible. The skill includes a bootstrap mechanism to ensure that the necessary Node.js scripts are always available in your ~/clawd/deepwork environment, allowing for seamless transition from installation to usage.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/adunne09/deepwork-tracker. Once installed, the agent will verify the presence of the execution script at ~/clawd/deepwork/deepwork.js. If the file is missing, the agent will automatically attempt to clone the repository from GitHub and initialize the environment. This ensures you are always running the latest version of the tracking engine without manual intervention.

Use Cases

This skill is perfect for professionals, students, or developers who utilize time-blocking techniques like the Pomodoro method or deep work sessions. You can use it to maintain a consistent log of your focused hours, evaluate your consistency over weekly or monthly intervals, and share visual progress reports with collaborators or accountability partners via Telegram. It is particularly useful for tracking progress toward long-term goals by generating contribution heatmaps that mirror GitHub's activity graphs.

Example Prompts

1. "Start a deep work session for 45 minutes and set the timer."
2. "Am I currently in a deep work session, and how long have I been going?"
3. "Show me my deep work graph for the last 30 days and send it to Alex on Telegram."

Tips & Limitations

To get the most out of this tool, ensure your shell environment has appropriate permissions to modify the ~/clawd directory. Note that the automatic timer functionality for macOS Clock relies on system-level accessibility permissions; ensure these are granted in your System Settings if the timer fails to trigger. While the tool is robust for local tracking, always verify that your data output format (text vs. telegram vs. heatmap) matches your intended destination to ensure the report displays correctly in your chat interface.