Quickstart

timetrace - Time Tracking

Overview

timetrace is a simple CLI for tracking your working time. Track time by project, generate reports, and integrate with shell prompts.

Quick Start

Start tracking time

sc timetrace start tracking <project>

Stop tracking time

sc timetrace stop tracking

Passthrough to timetrace CLI

sc timetrace _ <timetrace-args>

Key Features

• Simple Tracking: Start and stop time tracking for projects
• Project Management: Create and manage projects
• Reports: Generate time reports
• Shell Integration: Integrate with Starship and other prompts
• Multiple Install Methods: Homebrew, Snap, AUR, Scoop, Docker, Binary
• Configurable: 12-hour/24-hour clock, decimal hours, editor settings

Installation

brew install timetrace

Also available via:

• Snap
• AUR (Arch Linux)
• Scoop (Windows)
• Docker
• Binary

Usage Examples

Start tracking

timetrace start my-project

Stop tracking

timetrace stop

Check status

timetrace status

Create project

timetrace create project my-project

List projects

timetrace list projects

Generate report

timetrace report

Notes

• Run timetrace --help to see all available commands
• Supports shell integration with Starship
• Can be configured for 12-hour or 24-hour clock