timetrace
timetrace is a free and open-source CLI tool for tracking working time, offering simple and efficient time logging directly from the command line.
Last updated: 2025-05-13 22:52
timetrace
timetrace is a free and open-source CLI tool for tracking working time, offering simple and efficient time logging directly from the command line.
Source: https://github.com/dominikbraun/timetrace
Category: Time Tracking CLI Tools
Tags: open-source, command-line, personal-use, simple
Features
- Simple CLI-based time tracking: Start, stop, and manage time tracking directly from the terminal.
- Project and module support: Organize tracked time by projects and submodules (e.g.,
grind-beans@make-coffee). - Tagging: Add tags to time records for enhanced categorization.
- Billable/non-billable tracking: Mark records as billable or non-billable, with support for project-level defaults.
- Customizable configuration: Use a config file to set preferences, such as clock format (12/24 hour), decimal hour display, and preferred editor.
- Record management: Create, edit, and delete records, including belated record creation and restoration of deleted/edited records and projects.
- Status reporting: View current tracking status, total time worked today, and break time.
- Filtering and listing: Filter records by date, project, or billable status; list all projects or records for specific periods.
- Reports: Generate reports (in beta) with filters for date range, billable status, project, and output format (including JSON export).
- Shell integration: Integrate with the Starship shell prompt for real-time status display.
- Cross-platform installation: Available via Homebrew, Snap, AUR, Scoop, Docker, and binary releases.
Pricing
- Free and open-source
Usage Example
- Create a project:
timetrace create project make-coffee - Start tracking:
timetrace start make-coffee - Add tags:
timetrace start make-coffee +tag1 +tag2 - Stop tracking:
timetrace stop - List records:
timetrace list records today
Configuration Options
- Use 12-hour or 24-hour time format
- Display durations in decimal or mixed format
- Set default editor
- Per-project configuration (e.g., always billable)
For further details and advanced usage, see the timetrace GitHub repository.
Related Items
Asana Time Tracking (TrackingTime Integration)
A TrackingTime integration for Asana that lets teams track time on Asana tasks and projects directly from Asana, keeping accurate work logs without leaving the app.
Bartib
Bartib is a command-line time tracking tool that logs activities in plaintext files and provides flexible reporting options, making it suitable for straightforward personal time tracking.
Basecamp Time Tracking (TrackingTime Integration)
A TrackingTime integration for Basecamp that enables teams to track time on Basecamp projects and tasks, consolidating project work and time data.
billwarrior
An extension for Timewarrior that generates invoices in LaTeX format based on tracked time data.