Skip to content
This repository was archived by the owner on Apr 22, 2026. It is now read-only.

README.md

Latest commit

 

History

History
53 lines (34 loc) · 1.81 KB

README.md

File metadata and controls

53 lines (34 loc) · 1.81 KB
Raw

ProTimer

Local-first time tracking for freelancers and contractors who use Claude Code.

Screenshot 2026-02-14 at 14 49 14

Background

I built ProTimer while doing contracting work. I was excited by the ability to build new projects with AI and wanted a tool to track my billable hours as I worked with Claude Code.

However, I'm no longer growing my contracting business—I felt too spread thin across multiple projects. Instead of continuing to develop ProTimer commercially, I'm releasing it as open source for anyone else to build on, modify, or commercialize as they see fit.

I'm now focusing on the commitments I already have that are important to me, and leveraging AI depth-first rather than breadth-first. As part of this focus, I will not be accepting patches or pull requests, but forks are strongly encouraged.

Features

  • Automatic time tracking when Claude Code is active in your project directory (including nested child folders)
  • Manual time tracking with play/pause
  • Edit activity time ranges to correct tracking entries
  • Multiple project support with hourly rates
  • Invoice generation (PDF)
  • 100% local - all data stays on your machine
  • No cloud, no authentication, no subscription

Suggested Features

Ideas for forks and extensions:

  • Org & team cloud integration
  • Screen recording for demos

Quick Start

# Install dependencies
bun install
cd packages/app/ui && bun install && cd ../../../

# Run the desktop app
bun run dev

Data Storage

All data is stored locally on your machine:

  • Database: ~/.protimer/data.db (SQLite)
  • Activity log: ~/.protimer/claude-activity.jsonl
  • Invoices: ~/.protimer/invoices/

License

MIT License - see LICENSE file