promemoria

Intuitive Python based tool to create reminders in the shell.


Keywords
cli, productivity, reminders
License
MIT
Install
pip install promemoria==1.3.0

Documentation

GitHub

PyPI PyPI - Python Version PyPI - Downloads

Libraries.io dependency status for GitHub repo GitHub last commit GitHub Release Date

GitHub commits since latest release (by date)

Code style: black

[promemoria]

Intuitive Python based tool to create reminders in the shell.

promemoria is a Python based tool to help you stay organized and on top of your tasks! Quickly create reminders in the shell with the ability to set a title, description, priority and date to make sure you never forget anything.

Main features

  • Create and manage reminders directly from the shell.
  • Import the latest Issues and Pull Requests as reminders from a public GitHub repository. New feature
  • Automatically checks for expired reminders when opening a new shell. New feature

Installation

promemoria can be installed from PyPI by:

python3 -m pip install --upgrade promemoria

Usage

promemoria features a small and simple-to-use set of commands.
These commands can be easily retrieved at any moment by issuing promemoria help123

[promemoria]

Available commands.
-------------------

promemoria Shows the list of active reminders.
    --all Shows every reminder.

promemoria new Creates a new reminder
    -t title, string.
    -de description, string. 
    -da date, string, ISO 8601 compliant.
    -ti time, string.
    -p priority, integer, [1-3].

promemoria delete Deletes the specified reminder
    -i index, integer.

promemoria toggle Toggles the specified reminder
    -i index, integer.

promemoria clear Deletes every reminder

GitHub integration.
-------------------

promemoria gh Imports issues and pull requests from GitHub
    -r public repo, string [user/repo].
    -u user, string.
    --pulls Imports pull requests instead of issues.

Expired reminders check

The automatic check can be enabled by issuing the following command4:

promemoria-check enable

Examples

Quickly check your reminders

promemoria

which results in:

[promemoria]

You have 1 reminder(s).
-----------------------

◯ [1] Go get some groceries. !
      2023-07-12 08:30

Creating a reminder

promemoria new -t "Christmas" -de "It's Christmas\!" -da "2023-12-25" -p 3

which results in:

[promemoria]

Reminder created succesfully!
-----------------------------

◯ Christmas !!!
  It's Christmas!
  2023-12-25

Import from a GitHub repository

promemoria gh -r "python/cpython" -u "sobolevn"

which results5 in:

[promemoria]

Imported 1 issue(s).
____________________

◯ New warning: "'_Py_IsInterpreterFinalizing' undefined; assuming extern returning in" !!
  https://api.github.com/repos/python/cpython/issues/106406

Toggling a reminder

promemoria toggle -i 1

which results26 in:

[promemoria]

You toggled a reminder.
-----------------------

● Christmas !!!
  It's Christmas!
  2023-12-25

Footnotes

  1. Shouldn't promemoria work, try python3 -m promemoria.

  2. A color coded output will serve you better than this example. 2

  3. Referring to version 1.1.0

  4. Linux and macOS only, bash and zsh only.

  5. An example from the official Python repository.

  6. The mark changes and the title gets dimmed.