In simple English
This tool helps you track how you spend your work hours. You type simple commands into your terminal to start and stop a timer. It saves your logs locally on your computer. You do not need an internet connection or a paid account to use it. It costs you only your time to learn its text commands.
What it is
Timewarrior is a time-tracking utility that runs in the command line interface (a text-based window where you type instructions). It offers a simple stopwatch feature alongside flexible reporting tools.
What it is good for
Solo builders and developers who live inside the terminal can track billable hours or project time without opening a browser tab.
- Runs entirely in your terminal without slowing down your computer.
- Stores all your time records in local plain text files for easy backup.
- Includes flexible reporting commands to see your hours by day, week, or tag.
- Requires you to know how to use the command line and install software packages.
- Has no graphical user interface or automatic background time detection.
- You must compile it from source or use a package manager to install it.
manually writing time spent in a text file or paid time-tracking web apps
taskwarrior
- GothenburgBitFactory/taskwarrior6.1k stars
A command-line task manager from the same creators that pairs naturally with time tracking.
- clojure/clojure11k stars
Not a time tracker, but another command-line tool often used by terminal-heavy developers.
- jj-vcs/jj32k stars
A version control system that stores its history in Git repositories but handles changes and conflicts differently.
- WerWolv/ImHex55k stars
A hex editor with its own small language for describing the layout of a binary file.
brew install timewarrior