Set the
tmpo— A minimal CLI time tracker for developers.
tmpo allows you to track time effortlessly with simple commands that live in your terminal. Track time with automatic project detection, organize work into milestones, view stats, and export data; all without leaving your workspace.
tmpo is a lightweight, developer-friendly time tracking tool designed to integrate seamlessly with your terminal workflow. It automatically detects your project context from Git repositories or configuration files, making time tracking as simple as tmpo start and tmpo stop.
- 🚀 Fast & Lightweight - Built in Go, tmpo starts instantly and uses minimal resources
- 🎯 Automatic Project Detection - Detects project names from Git repos or
.tmporcconfiguration files - 🌐 Global Projects - Track time for any project from any directory without configuration files
- 🎯 Milestone Tracking - Organize time entries into sprints, releases, or project phases
- 💾 Local & Private Storage - All data stored locally in SQLite - your time tracking stays private
- 📊 Rich Reporting - View stats, export to CSV/JSON, and track hourly rates
- ⚡ Zero Configuration Needed - Works out of the box, configure only when you need to
Download the latest release for your platform from the releases page.
For detailed installation instructions for your platform:
git clone https://github.com/DylanDevelops/tmpo.git
cd tmpo
go build -o tmpo .# Start tracking (auto-detects project)
tmpo start
# Check status
tmpo status
# Stop tracking
tmpo stop
# View statistics
tmpo stats
# Organize work into milestones
tmpo milestone start "Sprint 1"Create global projects to track time from any directory:
# Create a global project
tmpo init --global
# Track time from anywhere on your system
cd /tmp
tmpo start --project "Client Work" "Implementing new feature"
tmpo stop
# View entries from anywhere
tmpo log --project "Client Work"For detailed usage and all commands, see the Usage Guide.
Set your preferences for currency, date/time formats, and timezone:
tmpo configThis opens an interactive wizard to configure:
- Currency (USD, EUR, GBP, JPY, and 30+ more)
- Date format (MM/DD/YYYY, DD/MM/YYYY, or YYYY-MM-DD)
- Time format (24-hour or 12-hour)
- Timezone (IANA format like America/New_York)
- Export path (default directory for exported files)
Local Projects (directory-specific):
# Create a .tmporc file in your project directory
tmpo init
# Or skip prompts and use defaults
tmpo init --accept-defaultsGlobal Projects (track from anywhere):
# Create a global project you can use from any directory
tmpo init --global
# Now track time from anywhere
tmpo start --project "Project Name"See the Configuration Guide for details.
Found a bug or have an idea for a feature you'd like to see in tmpo? Open an issue and our team will be able to help.
Contributions are welcome! See CONTRIBUTING.md for guidelines.
This project is licensed under the MIT License - see the LICENSE file for details.
Made with ❤️ by Dylan Ravel and you!