---
slug: "deepwork-tracker"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/adunne09/deepwork-tracker@main/README.md"
repo: "https://github.com/adunne09/deepwork-tracker"
source_file: "README.md"
branch: "main"
---
# deepwork-tracker

Local-first deep work session tracker (SQLite) plus a Clawdbot skill for chat control.

## What it does

- Start/stop deep work sessions (timestamps only)
- Stores sessions locally in SQLite
- Generates a simple dashboard-like report (last N days) including avg/median, sessions/day, trailing average, streak
- (Best-effort) starts a macOS Clock timer when a session begins

## Files

- `app/deepwork.js` — CLI app- `skill/deepwork-tracker/` — Clawdbot skill folder
- `dist/deepwork-tracker.skill` — packaged skill artifact

## Usage

```bash
node app/deepwork.js start --target-min 60
node app/deepwork.js stop
node app/deepwork.js report --days 7 --roll 7
node app/deepwork.js report --days 14 --show-total --show-active
```

## License

MIT