Devtrackr

Automatic work activity tracker for macOS — tracks your IDEs, meetings, and browser usage all day, then drops a polished Excel report on your desk at 6 PM with an AI-written summary of your day.

What it does

• Tracks time in VS Code, Rider, IntelliJ, Visual Studio, Jupyter, Xcode and more
• Detects meetings in Teams, Zoom, Webex, Skype, Google Meet, Slack huddles
• Knows which project you're in by reading the IDE window title
• Skips idle time — if you step away, it stops counting
• Reads your git commits and links them to the project you worked on
• Generates a daily Excel report at a time you choose (default 6 PM, Mon–Fri)
• AI narrative summary via a local Ollama model — 100% private, no cloud

Requirements

• macOS (uses AppleScript and launchd)
• Python 3.9+
• Ollama installed locally (optional, for AI summary)

Install

pip install devtrackr

Quick start

devtrackr init

That's it. The wizard asks five questions, then installs and starts the tracker automatically.

──────────────────────────────────────────────────
  Welcome to Devtrackr!
──────────────────────────────────────────────────

[1/5] Where are your git repos? (comma-separated paths)
      > ~/repos, ~/work/client-projects

[2/5] Where should daily reports be saved?
      > ~/Documents/WorkReports

[3/5] What time to generate the daily report? (24h)
      > 18

[4/5] Do you want an AI summary in your daily report?
      (requires Ollama installed) [Y/n]: Y

[5/5] Which Ollama model should generate the summary? [llama3.2:3b]:
        1. llama3.2:3b

✅ Config saved → ~/.devtrackr/config.toml
✅ Background tracker started
✅ Daily reports scheduled at 18:00 Mon–Fri
✅ Reports will be saved to: ~/Documents/WorkReports

Commands

Excel report

Each daily report contains four sheets:

Configuration

Config lives at ~/.devtrackr/config.toml. Edit it any time, or use the devtrackr config commands:

[paths]
repos_dirs  = ["~/repos", "~/work"]   # scan multiple repo roots
reports_dir = "~/Documents/WorkReports"
db_path     = "~/.devtrackr/logs.db"

[tracker]
poll_interval  = 10    # seconds between samples
idle_threshold = 300   # seconds idle before pausing
report_hour    = 18    # 24h — report fires Mon–Fri at this hour

[ai]
ollama_enabled = true
ollama_model   = "llama3.2:3b"
ollama_url     = "http://localhost:11434"

After editing, restart the tracker:

devtrackr stop && devtrackr start

Apps tracked

IDEs — VS Code, Visual Studio, Rider, IntelliJ IDEA, PyCharm, WebStorm, GoLand, Xcode, Jupyter (in browser)

Meetings — Microsoft Teams, Zoom, Webex, Skype, Google Meet, Slack (huddles), Discord (voice channels)

Browsers — Chrome, Firefox, Safari, Edge, Arc, Brave, Opera, Vivaldi

Terminal — Terminal, iTerm2, Warp, Hyper, Kitty, Ghostty

Privacy

Everything stays on your Mac:

• Activity data → ~/.devtrackr/logs.db (SQLite, only you can read it)
• Reports → your chosen folder
• AI summary → processed by Ollama running locally, nothing sent to the cloud

Contributing

Pull requests are welcome! Please open an issue first to discuss what you'd like to change.

git clone https://github.com/adeleye-art/devtrackr
cd devtrackr
pip install -e .
devtrackr init

❤️ Support this project

Devtrackr is free and open source. If it saves you time, consider buying me a coffee — it helps me keep working on it!

License

GNU GPL v3 © 2026 Adeleye Alarape