Timewarrior Command Line Time Tracking Reporting

---
name: "Timewarrior Command-Line Time Tracking and Reporting"
slug: "timewarrior-command-line-time-tracking-reporting"
description: "Timewarrior is a command-line time tracking tool from the Taskwarrior project. It records time intervals with tags, generates flexible reports, and integrates with Taskwarrior for automatic time tracking of tasks. Data is stored as plain text files with no database required."
github_stars: 1580
verification: "security_reviewed"
source: "https://github.com/GothenburgBitFactory/timewarrior"
category: "Calendar, Email & Productivity"
framework: "Multi-Framework"
tool_ecosystem:
  github_repo: "gothenburgbitfactory/timewarrior"
  github_stars: 1580
---

# Timewarrior Command-Line Time Tracking and Reporting

Timewarrior is a command-line time tracking tool from the Taskwarrior project. It records time intervals with tags, generates flexible reports, and integrates with Taskwarrior for automatic time tracking of tasks. Data is stored as plain text files with no database required.

## Installation

Use the upstream install or setup path that matches your environment:
- git clone --recurse-submodules https://github.com/GothenburgBitFactory/timewarrior
- cmake -DCMAKE_BUILD_TYPE=release -S . -B _build
- cmake --build _build -j

Requirements and caveats from upstream:
- Building Timewarrior yourself requires
- Python 3 (for running the testsuite)
- The cmake --install command may not require sudo depending on your choice of install location.

Basic usage or getting-started notes:
- Build Timewarrior, optionally run the test suite, and install it.

- Source: https://github.com/GothenburgBitFactory/timewarrior
- Extracted from upstream docs: https://raw.githubusercontent.com/GothenburgBitFactory/timewarrior/HEAD/README.md

## Source

- [Agent Skill Exchange](https://agentskillexchange.com/skills/timewarrior-command-line-time-tracking-reporting/)