v1.0.0

ptracker v1.0.0 — Stable Release 🎉

The first stable release of ptracker. Built in Rust, designed for freelancers who want to track their work without leaving the terminal.

What ptracker does

ptracker watches your project folders in real time, automatically tracking every file you create, modify, rename, or delete. Each work session is timed from start to finish. Everything is stored in ~/.ptracker so your data is available from any terminal on your machine.

What's in v1.0.0

• TUI dashboard — run ptracker with no args to launch an interactive project overview. Navigate with arrow keys, press Enter for sessions, w to watch, e to export.
• Session tracking — every watch session records start time, end time, duration, and a full breakdown of file activity
• sessions command — view all sessions for a project, filterable by date
• export command — generate a plain text client report with hours, sessions, and file activity totals
• clean command — manually compress old logs to .log.gz
• repair command — recover orphaned projects back into the global registry
• Log rotation — old log files are automatically compressed at the start of each new session
• Global storage — all data lives in ~/.ptracker, accessible from anywhere

Install

cargo install ptracker

All commands

ptracker                          # launch TUI dashboard
ptracker init "Project"           # initialize a project
ptracker watch "Project"          # start a session
ptracker summary "Project"        # view project details
ptracker sessions "Project"       # view session history
ptracker export "Project"         # generate client report
ptracker list                     # list all projects
ptracker log "Project" 3.5        # manually log hours
ptracker rename "Old" "New"       # rename a project
ptracker delete "Project"         # delete a project
ptracker clean "Project"          # compress old logs
ptracker repair                   # recover orphaned projects

Crate

https://crates.io/crates/ptracker

Full Changelog: v0.1.0-alpha...v1.0.0

v0.2.0-alpha

ptracker v0.2.0-alpha

⚠️ Pre-release — APIs and file formats may change before stable v1.0.0.

What's new

• Global ~/.ptracker storage — all projects in one place, accessible from any terminal
• Automatic session tracking — time starts when you watch, saves when you Ctrl+C
• list command — see all your projects in a table from anywhere
• Per-day session files and activity logs
• File event totals per session (created, modified, deleted, renamed)
• --path flag on init and watch
• --version flag

Install

cargo install ptracker

Crate

https://crates.io/crates/ptracker

Full Changelog: v0.1.0-alpha...v0.2.0-alpha

v0.1.0-alpha

ptracker v0.1.0-alpha

Initial pre-release of ptracker — a CLI tool for tracking projects, file activity, and hours for freelancers.

⚠️ This is a pre-release. APIs and file formats may change before stable v1.0.0.

Features

• init — initialize a new project
• watch — real-time file system monitoring with deduplication
• log — manually log hours to a project
• summary — view project details and activity logs in a table
• rename — rename a project and its associated files
• delete — remove a project and its logs

Install

cargo install ptracker

Crate

https://crates.io/crates/ptracker

Full Changelog: v0.1.0-alpha...v0.1.0-alpha