Simple Task Tracker CLI

A command-line interface (CLI) application to keep track of your tasks, their starting time, finishing time and their durations. The CLI uses a SQLite DB to store data.

Installation

You can install the package using either pipx or pip.

Note: It is highly recommended to install this package using pipx. It provides an isolated environment for installing and managing command-line tools. It also simplifies running CLIs without activating a virtual environment.
Check out this page to compare pip and pipx.

Using pipx (recommended)

pipx install simple-task-tracker

Using pip

pip install simple-task-tracker

Usage

After the installation, you can run the CLI application with the following command:

tt help

This will display the list of available commands and their descriptions.

Commands

• tt active: (or "a") List all active tasks.
• tt create: (or "c") Save a new task as ended. The ended time is the time right now, and the starting time is calculated using (now - duration_in_minutes).
• tt delete: (or "d") Delete a task.
• tt finish: (or "f") Mark a task as done. It can be restarted again using 'start' command. If no task is specified, stop the only active task.
• tt grep : (or "g") Search for tasks containing the given pattern (case insensitive). Optionally limit to a specific date.
• tt help : (or "h") Show help message.
• tt log : (or "l") Log all tasks of the day (DD-MM). If --date is not provided, today's date will be used.
• tt pause : (or "p") Pause the active task.
• tt resume: (or "r") Resume last stopped task.
• tt start : (or "s") Start a task.
• tt stats : Show statistics about your work patterns.
• tt week : (or "w") List all tasks for the current week along with their durations.

Contributing

Contributions are welcome! If you find any issues or have suggestions for improvements, please open an issue or submit a pull request on the GitHub repository.

License

This project is licensed under the MIT License.

Contact

If you have any questions or suggestions, feel free to contact me at ismailben44@gmail.com.