Skip to content

DylanDevelops/tmpo

tmpo CLI

Set the tmpo — A minimal CLI time tracker for developers.

screenshot of tmpo start and tmpo stats

tmpo allows you to track time effortlessly with simple commands that live in your terminal. Track time with automatic project detection, view stats, and export data; all without leaving your workspace.

About

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.

Why tmpo?

  • 🚀 Fast & Lightweight - Built in Go, tmpo starts instantly and uses minimal resources
  • 🎯 Automatic Project Detection - Detects project names from Git repos or .tmporc configuration files
  • 💾 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

Installation

Download Pre-built Binaries (Recommended)

Download the latest release for your platform from the releases page.

For detailed installation instructions for your platform:

Build from Source

git clone https://github.com/DylanDevelops/tmpo.git
cd tmpo
go build -o tmpo .

Quick Start

# Start tracking (auto-detects project)
tmpo start

# Check status
tmpo status

# Stop tracking
tmpo stop

# View statistics
tmpo stats

For detailed usage and all commands, see the Usage Guide.

Configuration

Optionally create a .tmporc file in your project to customize settings:

# Interactive form (prompts for name, rate, description)
tmpo init

# Or skip prompts and use defaults
tmpo init --accept-defaults

See the Configuration Guide for details.

Feedback

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.

Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines.

License

This project is licensed under the MIT License - see the LICENSE file for details.


Made with ❤️ by Dylan Ravel and you!

About

A minimal CLI time tracker for developers.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Sponsor this project

 

Languages