timetrackd

Time tracking daemon for Docker-based projects.

It watches Docker container start/stop events, maps containers to git repos, and records time per project + git branch.

Requirements

• Rust toolchain (for building/installing)
• Docker (local socket)
• Linux desktop notifications are optional (via notify-rust/libnotify)

Install

Quick install (recommended)

./install.sh

This builds and installs the binary with Cargo, creates ~/.timetrackd/config.toml (if missing), and installs the user-level systemd unit.

Enable autostart:

systemctl --user enable timetrackd
systemctl --user start timetrackd

Manual

cargo install --path .
timetrackd config init

Usage

Start/stop:

timetrackd start
timetrackd stop
timetrackd status

List active projects:

timetrackd list

Pause/resume tracking:

timetrackd pause <id>
timetrackd resume <id>

# or omit <id> when run from within the project directory
timetrackd pause
timetrackd resume

Reports:

timetrackd today
timetrackd week
timetrackd report --from 2026-01-01 --to 2026-01-31
timetrackd report --branch main
timetrackd report --project my-service

Export:

timetrackd export --format csv --output out.csv
timetrackd export --format json --output out.json --from 2026-01-01 --to 2026-01-31

Config

timetrackd config show
timetrackd config init
timetrackd config path

The config file lives at ~/.timetrackd/config.toml.

Data Files

All state is stored under ~/.timetrackd/:

• data.json: completed sessions + active projects
• config.toml: user configuration
• daemon.sock: daemon control socket
• daemon.pid: PID file used for status checks

systemd service

See timetrackd.service. The unit runs timetrackd start --foreground as a user service.

Development

cargo fmt
cargo test
cargo run -- start --foreground