TIME-TRACKER

❯ tt working on Ticket-3

Overview

A local-first timetracking tool written in Go. This application is designed for developers or technical users who want to track time without relying on complex services, accounts, or cloud infrastructure. It runs as a command-line application, stores data locally, and is easy to extend or integrate into other workflows.

Features

• Simple time tracking: Start at the beginning of work and then write out what you did until now.
• Local storage: Keeps data on your machine in a Bold-DB
• CLI-first: Optimized for use directly from the terminal
• Minimalist design: Easy to read, understand, and modify

Getting Started

Prerequisites

No Prerequisites needed for running. It is a static compiled binary for the common operating systems.

For building tho you need go installed.

Installation

Install time-tracker using one of the following methods:

Download:

Download the latest release here.

Recommendations:

• Put the binary in a folder because the .db file will be created next to the binary
• append the directory to the PATH variable for easy usage

Build from source:

1. Clone the time-tracker repository:

❯ git clone https://github.com/LReg/time-tracker

2. Navigate to the project build-directory:

❯ cd time-tracker/build

3. Use the correct bash-buildscript for your OS:

❯ cd ./buildXXX.sh

Usage

• tt start starts your day so you know when you started working
• tt I did stuff on ticket-28 tracks what you did since the last execution
• tt version displays your current installed version
• tt show opens a local website in your browser that displays you tracked times

Project Roadmap

• Upgrade to Angular UI
• Write tests
• Integrate with std-in for example git commit -m "abc" | tt