(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.
1 maintainer
Metadata
1 maintainer
Release files for better-timetagger-cli 0.6.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| better_timetagger_cli-0.6.1.tar.gz | 147.3 kB | With provenance | Details for better_timetagger_cli-0.6.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| better_timetagger_cli-0.6.1-py3-none-any.whl | Python 3 | none | any | Details for better_timetagger_cli-0.6.1-py3-none-any.whl |
Total release size: 185.7 kB
Release files / better_timetagger_cli-0.6.1.tar.gz
| Download URL | better_timetagger_cli-0.6.1.tar.gz |
|---|---|
| Size | 147.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0d516bb4feec60e220d00c81b9df6b77031df6a82a257d32efa1b11b6784e812
|
|
BLAKE2b-256 checksum How to use checksums |
166a79d242d02ad7979307d46a0976d7753e26cc32bd42d607d8437947b0575b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2025.
Transparency logRelease files / better_timetagger_cli-0.6.1-py3-none-any.whl
| Download URL | better_timetagger_cli-0.6.1-py3-none-any.whl |
|---|---|
| Size | 38.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6a2e5a4f0cfc2fa0818f59fe9386b98d095639503af112a8589de3f93e6cf427
|
|
BLAKE2b-256 checksum How to use checksums |
718bc6d8dcaaf6eb96402c1f744e7561eeb2de80fddb11fb051b79e979341dd8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2025.
Transparency logSecurity for better-timetagger-cli 0.6.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for better_timetagger_cli-0.6.1.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2025.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
