track-time-cli 0.1.0

A small command-line time tracker with sheets, notes, and Rich-formatted output.

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

1. Create or switch to a sheet:

   tt sheet my-project
   

2. Start tracking:

   tt in "Implementing feature X"
   

3. Stop tracking:

   tt out
   

4. 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.