tmpo is a minimal CLI time tracker designed specifically for developers, offering an efficient solution for managing work hours directly from the terminal. With its intuitive command-line interface, users can easily track time, view statistics, and export data—all without interrupting their workflow.

Key Features

• Fast & Lightweight: Built in Go, tmpo starts quickly and consumes minimal system resources, ensuring smooth performance.
• Automatic Project Detection: Effortlessly detects project names from Git repositories or the .tmporc configuration files, eliminating the need for manual entry.
• Local & Private Storage: All time tracking data is stored locally in SQLite, ensuring that user information remains private and secure.
• Rich Reporting Options: Users can generate detailed reports and export their data in CSV or JSON format, allowing for comprehensive analysis of their working hours.
• Zero Configuration Required: tmpo works out of the box with no setup necessary; however, advanced configuration options are available for those who need them.

Quick Usage

Begin tracking time with simple commands:

# Start tracking (automatically detects the project context)
tmpo start

# Check the current tracking status
tmpo status

# Stop tracking
tmpo stop

# View statistics
tmpo stats

For a more customized experience, users can create a .tmporc file in their project to configure settings interactively:

# Set up project configuration interactively
tmpo init

# Use defaults and skip prompts
tmpo init --accept-defaults

Community and Contributions

Feedback and contributions are encouraged. Users can report bugs or suggest features by opening an issue on the GitHub repository. Contributions can also be made following the established guidelines.

Explore and Get Started

Visit the releases page to download the latest version and start tracking time efficiently with tmpo.