litt

A low-intrusion CLI time tracker with a minimal workflow, REST API, and simple JSON storage for easy integration.

Time Tracking CLI Tools
5/13/2025
View Source

litt

A low-intrusion CLI time tracker with a minimal workflow, REST API, and simple JSON storage for easy integration.

Source: https://github.com/Riebart/litt

Category: time-tracking-cli-tools

Tags: open-source, command-line, api, minimalist

Features

  • Command-Line Interface: Provides a fast and terse CLI for time tracking.
  • Minimal Workflow Footprint: Designed for minimal disruption and quick usage, can be integrated into keyboard macros.
  • Simple JSON File Database: Stores all time tracking data in a single JSON file for easy manual editing and interoperability.
  • REST API: Exposes a basic REST API for integration with other tools and systems.
  • Stopwatch Mode: Start/stop a stopwatch to log time entries, suitable for inline workflow usage.
  • Ledger Mode: Manually add time records with start and end times.
  • Aliases: Define aliases to quickly assign descriptions, tags, and other options to time entries.
  • Edit/Amend Time Records: Modify existing records using commands or direct JSON file editing for complex changes.
  • Filtering and Exporting: List and filter tracked time data, export in CSV, JSON, YAML, and other formats.
  • Tagging: Add tags to time records for categorization and filtering.
  • Hooks: Run custom scripts (hooks) at specific events (pre/post commit, config changes, etc.) for automation.
  • Configurable: Supports persistent and per-command configuration options.
  • Cross-Platform: Stores data in user home directory on both Linux and Windows.
  • Extensible: Advanced users can edit the JSON database directly or use tools like jq.
  • Short and Long Option Forms: All CLI options have both short and long forms for convenience.
  • Flexible Date Parsing: Uses dateparser to accept absolute or relative date/time specifications.
  • No Complex History Editing: Keeps history simple, but allows manual edits for advanced needs.

Pricing

  • Open Source: No cost, available under an open source license.

Installation

  • Requires Python and the dateparser package. Full dependencies listed in requirements.txt.

For more details and usage examples, visit the GitHub repository.

Related Tags

open-source
command-line
api
minimalist