Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

Tracks issues and TODOs in a standalone branch in your repository.

Project description


A small script to manage TODO-entries inside a git repository. A personal
project, with sparse documentation. Try ``git-todo --help`` to get detailed
information about each command.


When ``git-todo`` is found via ``$PATH``, git will find it if you run ``git
todo``. This is useful when using it from inside a `repl


Initializing a new TODO list and edit entries:

.. code-block:: sh

git todo new
git todo edit

A valid list:

.. code-block:: txt

x Do dishes.
* Cleanup apartment.
* Achieve world domination.
! Call mum on her birthday.

Running ``git todo``, which is a shortcut for ``git todo list``, yields the
following (colorful) results:

.. code-block:: sh

git todo

.. code-block:: txt

! Call mum on her birthday.
* Cleanup apartment.
* Achieve world domination.
x Do dishes.

Note that completed tasks (``x``) have been moved to the end and important
(``!``) tasks to the front.


Headings can be added in a format similar to `ReStructured Text

.. code-block:: txt

x Do dishes.
* Cleanup apartment.
! Call mum on her birthday.

Project X
! Get started.
* Achieve world domination.
x Dream Big.


TODOs are kepy in a regular git branch that contains a single file:

.. code-block:: sh

git log --format=oneline todo

.. code-block:: txt

29e941f005de2fa998939b674ed7c4be47a93649 Updated TODO
8330b8167b4393f07ccc0f712301f0630f470a9e Initial commit for TODO branch

Project details

Release history Release notifications

History Node


This version
History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
git-todo-0.1.tar.gz (4.5 kB) Copy SHA256 hash SHA256 Source None Aug 23, 2015

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page