(Better) TimeTagger CLI

Track your time with TimeTagger from the command line.

TimeTagger is a (self-)hosted time tracking tool that helps you keep track of time spent on your tasks and projects.

This project provides a command-line interface (CLI) for the TimeTagger time tracking application, allowing you to manage your time entries directly from your terminal. It is a more feature-rich and ergonomic fork of the original timetagger-cli by Almar Klein, adding a more user-friendly interface along with a number of new features, such as:

	better-timetagger-cli	timetagger-cli
Start / stop tasks	✅	✅
Resume previous tasks	✅	✅
Display status update	✅	✅
List records by timeframe	✅	✅
Diagnose & fix database errors	✅	✅
Natural language support date/time	✅	✅
Easily tag records	✅	❌
Filter tasks by tags	✅	❌
Summary per tag	✅	❌
Hide / restore records	✅	❌
Export records to CSV	✅	❌
Import records from CSV	✅	❌
Preview records from CSV	✅	❌
Color-code output and render tables	✅	❌
Output rounded record times	✅	❌
Configurable date/time formats	✅	❌
Command aliases	✅	❌

🚀 Quickstart

1. Install the `better-timetagger-cli` package.

$ pipx install better-timetagger-cli

2. Update the configuration with your `base_url` and `api_token`.

$ t setup

3. Review CLI commands and options.

$ t --help
# Usage: t [OPTIONS] COMMAND [ARGS]...
#
# Options:
#   ...
#
# Commands:
#   ...

$ t start --help
# Usage: t start [OPTIONS] [TAGS]...
#
# Options:
#   ...

4. Manage your time with the command line interface.

$ t start client-a
#         Started             Stopped             Duration   Description
# ──────────────────────────────────────────────────────────────────────
#   Tue   27-May-2025 08:15   ...                       0m   #client-a

$ t stop -a "in 15 minutes"
#         Started             Stopped             Duration   Description
# ──────────────────────────────────────────────────────────────────────
#   Tue   27-May-2025 08:15   27-May-2025 08:30        15m   #client-a

$ t show -s yesterday
#         Started             Stopped             Duration   Description
# ──────────────────────────────────────────────────────────────────────
#   Tue   27-May-2025 08:15   27-May-2025 08:30        15m   #client-a
#   Mon   26-May-2025 13:20   26-May-2025 17:57     4h 37m   #client-b
#   Mon   26-May-2025 09:34   26-May-2025 12:40     3h  6m   #client-b

$ t export -s "monday 8am" -e "friday 6pm" -o records.csv
# Exported 3 records to 'records.csv'.

📚 Documentation

For complete instructions, configuration details, and advanced features, visit the full documentation on Read the Docs.

🤝 Contributing

You are welcome to file bug reports and feature requests by opening a github issue on this repository. If you’d like to contribute code, please consider starting with an issue to discuss the change before opening a pull request, to allow for a discussion of the intended change.

Pull requests (PRs) are appreciated and should reference a related bug report or feature request.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

better_timetagger_cli-0.6.1.tar.gz (147.3 kB view details)

Uploaded Oct 16, 2025 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

better_timetagger_cli-0.6.1-py3-none-any.whl (38.4 kB view details)

Uploaded Oct 16, 2025 Python 3

File details

Details for the file better_timetagger_cli-0.6.1.tar.gz.

File metadata

Download URL: better_timetagger_cli-0.6.1.tar.gz
Upload date: Oct 16, 2025
Size: 147.3 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for better_timetagger_cli-0.6.1.tar.gz
Algorithm	Hash digest
SHA256	`0d516bb4feec60e220d00c81b9df6b77031df6a82a257d32efa1b11b6784e812`
MD5	`eb83d2c3866a54335f1dc1872f6abdbc`
BLAKE2b-256	`166a79d242d02ad7979307d46a0976d7753e26cc32bd42d607d8437947b0575b`

See more details on using hashes here.

Provenance

The following attestation bundles were made for better_timetagger_cli-0.6.1.tar.gz:

Publisher: auto-release.yml on PassionateBytes/better-timetagger-cli

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: better_timetagger_cli-0.6.1.tar.gz
- Subject digest: 0d516bb4feec60e220d00c81b9df6b77031df6a82a257d32efa1b11b6784e812
- Sigstore transparency entry: 613641044
- Sigstore integration time: Oct 16, 2025
Source repository:
- Permalink: PassionateBytes/better-timetagger-cli@41151f8de4d9ad156642df4d1ac040b15d0866f7
- Branch / Tag: refs/heads/main
- Owner: https://github.com/PassionateBytes
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: auto-release.yml@41151f8de4d9ad156642df4d1ac040b15d0866f7
- Trigger Event: push