Skip to main content

Icon

td-cli

td-cli is a command line todo manager,
where you can organize and manage your todos across multiple projects

gif


Installation

td-cli only works for python 3, so it needs to be installed with pip3

pip3 install td-cli

Getting started

Run td --help to see possible commands.

Here are some to get you started:

  • Run td to list all your todos.

  • Run td add "my new awesome todo" to add a new todo.

  • Run td <id> complete to complete your todo. You don't have to specify the whole id, a substring will do. It'll fetch the first one that it finds in the same order as when you list your todos.

Note that global is a preserved group name where you can list all your global groups. You can always set it as the default with:

td group global preset

API

Check out the api.

Configuring

Database name

Your database instance will be located in your home directory (~/). By default it'll be named todo.

You can change your database name by specifying database_name in your ~/.td.cfg file:

[settings]
database_name: something_else

This results in a database instance at ~/.something_else.db

Editor

When editing a todo, td <id> edit, you can both specify the todo's name and the todo's details. If no option is specified, your todo will be opened in vi by default (your environement EDITOR will override this) where you can edit the todo's details. You can change the default editor by updating your config:

[settings]
editor: nvim

Group

When listing todos, you have the option of specifying what group to list from:

td -g my-group
# or
td g my-group

If no group is provided, td will list from the current default group. You can globally set the default group with:

td g my-group preset

However, there's an option to set the default group per git project (this is not possible from the root config ~/.td.cfg). In the root of your git project, you can create a .td.cfg config file to specify what group to default on (this will override the global default group):

[settings]
group: my-group

If you run td within your git project, td will default to my-group.

I recommend globally ignoring .td.cfg in ~/.gitignore.

Download files

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

Source Distribution

td-cli-1.0.0.tar.gz (19.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

td_cli-1.0.0-py2.py3-none-any.whl (36.3 kB view details)

Uploaded Python 2Python 3

File details

Details for the file td-cli-1.0.0.tar.gz.

File metadata

  • Download URL: td-cli-1.0.0.tar.gz
  • Upload date:
  • Size: 19.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.6.3 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.7.2

File hashes

Hashes for td-cli-1.0.0.tar.gz
Algorithm Hash digest
SHA256 f87594f28df5c8352812887197685d8f5c01a9ae92ce4298882a8ca62cf31cfc
MD5 c34d31c899b3336db58706ed258f0b77
BLAKE2b-256 3a2d04520ee07ed0331e82461c95640adac5ac595a0a02a3ba8fcf7e6d1946c5

See more details on using hashes here.

File details

Details for the file td_cli-1.0.0-py2.py3-none-any.whl.

File metadata

  • Download URL: td_cli-1.0.0-py2.py3-none-any.whl
  • Upload date:
  • Size: 36.3 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.6.3 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.7.2

File hashes

Hashes for td_cli-1.0.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 68c3c12c50ddf3e7ec099855c12c0826887a6598430c39ed52aa29878688a248
MD5 029256557c11dbee7ed75f48780be43a
BLAKE2b-256 56d351dd4a1228890a5ffe09971f9d9f120aae80840bad4bbdd8109117b6e7a8

See more details on using hashes here.

Release history Release notifications | RSS feed

2.3.0

2 files

2.2.3

2 files

2.2.2

2 files

2.2.1

2 files

2.2.0

2 files

2.1.1

2 files

2.1.0

2 files

2.0.3

2 files

2.0.2

2 files

2.0.1

2 files

2.0.0

2 files

1.3.0

2 files

1.2.6

2 files

1.2.5

2 files

1.2.4

2 files

1.2.3

2 files

1.2.2

2 files

1.2.1

2 files

1.2.0

2 files

1.1.0

2 files

This release

1.0.0 This release

2 files

0.1.17

2 files

0.1.16

2 files

0.1.15

2 files

0.1.14

2 files

0.1.13

2 files

0.1.12

2 files

0.1.11

2 files

0.1.10

2 files

0.1.9

2 files

0.1.8

2 files

0.1.7

2 files

0.1.6

2 files

0.1.5

2 files

0.1.4

2 files

0.1.3

2 files

0.1.2

2 files

0.1.1

2 files

0.1.0

2 files

0.0.1

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page