track-time-cli

A small command-line time tracker. Organize work into sheets, clock in and out, attach notes to running entries, and inspect totals with formatted tables (via Rich).

Installation

From PyPI:

pip install track-time-cli

The CLI is installed as tt.

Quick start

Create or switch to a sheet:
```
tt sheet my-project
```
Start tracking:
```
tt in "Implementing feature X"
```
Stop tracking:
```
tt out
```
With no subcommand, tt shows the current running entry (if any):
```
tt
```

Data

State is stored under your home directory:

~/.track-time-cli/db.json

Commands

Command	Description
`tt`	Show the active running entry and its notes, if any.
`tt in <description> [--at <time>]`	Check in on the active sheet. `--at` accepts natural language (e.g. `10 minutes ago`) via dateparser.
`tt out [--at <time>]`	Check out the running entry.
`tt list`	List all entries on the active sheet with durations and totals.
`tt sheet <name>`	Create the sheet if needed, then switch to it as active.
`tt sheet <name> --delete` / `-d`	Delete a sheet (prompts if it has entries).
`tt sheets`	List all sheets with entry counts and total time.
`tt note <text> [--at <time>]`	Append a note to the running entry.
`tt edit <description>`	Change the description of the running entry.
`tt resume`	Start a new entry copying the description of the last completed entry on the active sheet.
`tt cancel`	Remove the running entry without recording it.

Dependencies

Runtime dependencies are declared in pyproject.toml: Typer, Rich, humanize, and dateparser.

Metadata

Release files for track-time-cli 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for track-time-cli 0.1.0
File	Size	Uploaded
track_time_cli-0.1.0.tar.gz	7.5 kB	Apr 15, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for track-time-cli 0.1.0
File	Interpreter	ABI	Platform	Reset
track_time_cli-0.1.0-py3-none-any.whl 8.5 kB Apr 15, 2026	Python 3	none	any	Details

Total release size: 16.0 kB

Release files / track_time_cli-0.1.0.tar.gz

Download URL	track_time_cli-0.1.0.tar.gz
Size	7.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`7a91060e9688322aeefddbdd492f64b68c19ce1a67c4780ead52963c463373d7`
BLAKE2b-256 checksum How to use checksums	`0c99601a62ccecf89f9588004bd82ff86ef08dfca70b2abf1813db27c464fce9`
Upload date	Apr 15, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.14.3`

Release files / track_time_cli-0.1.0-py3-none-any.whl

Download URL	track_time_cli-0.1.0-py3-none-any.whl
Size	8.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`6871698d9295a37a08f153c8c9d13a43bb049e6ca5b726dad4a7f5de138bd049`
BLAKE2b-256 checksum How to use checksums	`d88640db6783e47b9cee5d8d052da180234cda2088519fbd30a9a75b20f96b51`
Upload date	Apr 15, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.14.3`

Release history Release notifications | RSS feed

This release

0.1.0 This release

Apr 15, 2026 2 release files

track-time-cli 0.1.0