Skip to content

A command-line interface (CLI) application to keep track of your tasks, their starting time, finishing time and their durations.

License

Notifications You must be signed in to change notification settings

ismailbenhallam/simple-task-tracker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Simple Task Tracker CLI

PyPI - Version PyPI - Python Version GitHub License

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.

About

A command-line interface (CLI) application to keep track of your tasks, their starting time, finishing time and their durations.

Topics

Resources

License

Stars

Watchers

Forks

Languages