A todo command line manager
Project description
td-cli
td-cli is a command line todo manager,
where you can organize and manage your todos across multiple projects
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 wholeid
, 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
.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for td_cli-1.0.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 68c3c12c50ddf3e7ec099855c12c0826887a6598430c39ed52aa29878688a248 |
|
MD5 | 029256557c11dbee7ed75f48780be43a |
|
BLAKE2b-256 | 56d351dd4a1228890a5ffe09971f9d9f120aae80840bad4bbdd8109117b6e7a8 |